diff --git a/README.md b/README.md index 75328a1252b..12b3e038acf 100644 --- a/README.md +++ b/README.md @@ -457,6 +457,7 @@ RubyGems.org page under "LINKS" section. | AWS Support App | Aws::SupportApp | aws-sdk-supportapp | 2021-08-20 | | AWS Systems Manager Incident Manager | Aws::SSMIncidents | aws-sdk-ssmincidents | 2018-05-10 | | AWS Systems Manager Incident Manager Contacts | Aws::SSMContacts | aws-sdk-ssmcontacts | 2021-05-03 | +| AWS Systems Manager QuickSetup | Aws::SSMQuickSetup | aws-sdk-ssmquicksetup | 2018-05-10 | | AWS Systems Manager for SAP | Aws::SsmSap | aws-sdk-ssmsap | 2018-05-10 | | AWS Telco Network Builder | Aws::Tnb | aws-sdk-tnb | 2008-10-21 | | AWS Transfer Family | Aws::Transfer | aws-sdk-transfer | 2018-11-05 | diff --git a/apis/bedrock/2023-04-20/api-2.json b/apis/bedrock/2023-04-20/api-2.json index da802ef9ce8..191bc8f4c76 100644 --- a/apis/bedrock/2023-04-20/api-2.json +++ b/apis/bedrock/2023-04-20/api-2.json @@ -2,9 +2,10 @@ "version":"2.0", "metadata":{ "apiVersion":"2023-04-20", + "auth":["aws.auth#sigv4"], "endpointPrefix":"bedrock", - "jsonVersion":"1.1", "protocol":"rest-json", + "protocols":["rest-json"], "serviceFullName":"Amazon Bedrock", "serviceId":"Bedrock", "signatureVersion":"v4", @@ -71,6 +72,23 @@ {"shape":"ThrottlingException"} ] }, + "CreateModelCopyJob":{ + "name":"CreateModelCopyJob", + "http":{ + "method":"POST", + "requestUri":"/model-copy-jobs", + "responseCode":201 + }, + "input":{"shape":"CreateModelCopyJobRequest"}, + "output":{"shape":"CreateModelCopyJobResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InternalServerException"}, + {"shape":"TooManyTagsException"} + ], + "idempotent":true + }, "CreateModelCustomizationJob":{ "name":"CreateModelCustomizationJob", "http":{ @@ -253,6 +271,23 @@ {"shape":"ThrottlingException"} ] }, + "GetModelCopyJob":{ + "name":"GetModelCopyJob", + "http":{ + "method":"GET", + "requestUri":"/model-copy-jobs/{jobArn}", + "responseCode":200 + }, + "input":{"shape":"GetModelCopyJobRequest"}, + "output":{"shape":"GetModelCopyJobResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"InternalServerException"}, + {"shape":"ThrottlingException"} + ] + }, "GetModelCustomizationJob":{ "name":"GetModelCustomizationJob", "http":{ @@ -367,6 +402,23 @@ {"shape":"ThrottlingException"} ] }, + "ListModelCopyJobs":{ + "name":"ListModelCopyJobs", + "http":{ + "method":"GET", + "requestUri":"/model-copy-jobs", + "responseCode":200 + }, + "input":{"shape":"ListModelCopyJobsRequest"}, + "output":{"shape":"ListModelCopyJobsResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"InternalServerException"}, + {"shape":"ThrottlingException"} + ] + }, "ListModelCustomizationJobs":{ "name":"ListModelCustomizationJobs", "http":{ @@ -556,6 +608,10 @@ }, "exception":true }, + "AccountId":{ + "type":"string", + "pattern":"[0-9]{12}" + }, "AutomatedEvaluationConfig":{ "type":"structure", "required":["datasetMetricConfigs"], @@ -718,6 +774,30 @@ "version":{"shape":"GuardrailNumericalVersion"} } }, + "CreateModelCopyJobRequest":{ + "type":"structure", + "required":[ + "sourceModelArn", + "targetModelName" + ], + "members":{ + "sourceModelArn":{"shape":"ModelArn"}, + "targetModelName":{"shape":"CustomModelName"}, + "modelKmsKeyId":{"shape":"KmsKeyId"}, + "targetModelTags":{"shape":"TagList"}, + "clientRequestToken":{ + "shape":"IdempotencyToken", + "idempotencyToken":true + } + } + }, + "CreateModelCopyJobResponse":{ + "type":"structure", + "required":["jobArn"], + "members":{ + "jobArn":{"shape":"ModelCopyJobArn"} + } + }, "CreateModelCustomizationJobRequest":{ "type":"structure", "required":[ @@ -792,7 +872,7 @@ "type":"string", "max":63, "min":1, - "pattern":"([0-9a-zA-Z][_-]?)+" + "pattern":"([0-9a-zA-Z][_-]?){1,63}" }, "CustomModelSummary":{ "type":"structure", @@ -809,7 +889,8 @@ "creationTime":{"shape":"Timestamp"}, "baseModelArn":{"shape":"ModelArn"}, "baseModelName":{"shape":"ModelName"}, - "customizationType":{"shape":"CustomizationType"} + "customizationType":{"shape":"CustomizationType"}, + "ownerAccountId":{"shape":"AccountId"} } }, "CustomModelSummaryList":{ @@ -1333,6 +1414,41 @@ "kmsKeyArn":{"shape":"KmsKeyArn"} } }, + "GetModelCopyJobRequest":{ + "type":"structure", + "required":["jobArn"], + "members":{ + "jobArn":{ + "shape":"ModelCopyJobArn", + "location":"uri", + "locationName":"jobArn" + } + } + }, + "GetModelCopyJobResponse":{ + "type":"structure", + "required":[ + "jobArn", + "status", + "creationTime", + "targetModelArn", + "sourceAccountId", + "sourceModelArn" + ], + "members":{ + "jobArn":{"shape":"ModelCopyJobArn"}, + "status":{"shape":"ModelCopyJobStatus"}, + "creationTime":{"shape":"Timestamp"}, + "targetModelArn":{"shape":"CustomModelArn"}, + "targetModelName":{"shape":"CustomModelName"}, + "sourceAccountId":{"shape":"AccountId"}, + "sourceModelArn":{"shape":"ModelArn"}, + "targetModelKmsKeyArn":{"shape":"KmsKeyArn"}, + "targetModelTags":{"shape":"TagList"}, + "failureMessage":{"shape":"ErrorMessage"}, + "sourceModelName":{"shape":"CustomModelName"} + } + }, "GetModelCustomizationJobRequest":{ "type":"structure", "required":["jobIdentifier"], @@ -2135,6 +2251,11 @@ "shape":"SortOrder", "location":"querystring", "locationName":"sortOrder" + }, + "isOwned":{ + "shape":"Boolean", + "location":"querystring", + "locationName":"isOwned" } } }, @@ -2256,6 +2377,68 @@ "nextToken":{"shape":"PaginationToken"} } }, + "ListModelCopyJobsRequest":{ + "type":"structure", + "members":{ + "creationTimeAfter":{ + "shape":"Timestamp", + "location":"querystring", + "locationName":"creationTimeAfter" + }, + "creationTimeBefore":{ + "shape":"Timestamp", + "location":"querystring", + "locationName":"creationTimeBefore" + }, + "statusEquals":{ + "shape":"ModelCopyJobStatus", + "location":"querystring", + "locationName":"statusEquals" + }, + "sourceAccountEquals":{ + "shape":"AccountId", + "location":"querystring", + "locationName":"sourceAccountEquals" + }, + "sourceModelArnEquals":{ + "shape":"ModelArn", + "location":"querystring", + "locationName":"sourceModelArnEquals" + }, + "targetModelNameContains":{ + "shape":"CustomModelName", + "location":"querystring", + "locationName":"outputModelNameContains" + }, + "maxResults":{ + "shape":"MaxResults", + "location":"querystring", + "locationName":"maxResults" + }, + "nextToken":{ + "shape":"PaginationToken", + "location":"querystring", + "locationName":"nextToken" + }, + "sortBy":{ + "shape":"SortJobsBy", + "location":"querystring", + "locationName":"sortBy" + }, + "sortOrder":{ + "shape":"SortOrder", + "location":"querystring", + "locationName":"sortOrder" + } + } + }, + "ListModelCopyJobsResponse":{ + "type":"structure", + "members":{ + "nextToken":{"shape":"PaginationToken"}, + "modelCopyJobSummaries":{"shape":"ModelCopyJobSummaries"} + } + }, "ListModelCustomizationJobsRequest":{ "type":"structure", "members":{ @@ -2409,6 +2592,48 @@ "min":20, "pattern":"arn:aws(-[^:]+)?:bedrock:[a-z0-9-]{1,20}:(([0-9]{12}:custom-model/[a-z0-9-]{1,63}[.]{1}[a-z0-9-]{1,63}/[a-z0-9]{12})|(:foundation-model/[a-z0-9-]{1,63}[.]{1}([a-z0-9-]{1,63}[.]){0,2}[a-z0-9-]{1,63}([:][a-z0-9-]{1,63}){0,2}))" }, + "ModelCopyJobArn":{ + "type":"string", + "max":1011, + "min":0, + "pattern":"arn:aws(-[^:]+)?:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:model-copy-job/[a-z0-9]{12}" + }, + "ModelCopyJobStatus":{ + "type":"string", + "enum":[ + "InProgress", + "Completed", + "Failed" + ] + }, + "ModelCopyJobSummaries":{ + "type":"list", + "member":{"shape":"ModelCopyJobSummary"} + }, + "ModelCopyJobSummary":{ + "type":"structure", + "required":[ + "jobArn", + "status", + "creationTime", + "targetModelArn", + "sourceAccountId", + "sourceModelArn" + ], + "members":{ + "jobArn":{"shape":"ModelCopyJobArn"}, + "status":{"shape":"ModelCopyJobStatus"}, + "creationTime":{"shape":"Timestamp"}, + "targetModelArn":{"shape":"CustomModelArn"}, + "targetModelName":{"shape":"CustomModelName"}, + "sourceAccountId":{"shape":"AccountId"}, + "sourceModelArn":{"shape":"ModelArn"}, + "targetModelKmsKeyArn":{"shape":"KmsKeyArn"}, + "targetModelTags":{"shape":"TagList"}, + "failureMessage":{"shape":"ErrorMessage"}, + "sourceModelName":{"shape":"CustomModelName"} + } + }, "ModelCustomization":{ "type":"string", "enum":[ diff --git a/apis/bedrock/2023-04-20/docs-2.json b/apis/bedrock/2023-04-20/docs-2.json index 74b08f9ca35..8c7ec5f9a42 100644 --- a/apis/bedrock/2023-04-20/docs-2.json +++ b/apis/bedrock/2023-04-20/docs-2.json @@ -2,36 +2,39 @@ "version": "2.0", "service": "

Describes the API operations for creating, managing, fine-turning, and evaluating Amazon Bedrock models.

", "operations": { - "CreateEvaluationJob": "

API operation for creating and managing Amazon Bedrock automatic model evaluation jobs and model evaluation jobs that use human workers. To learn more about the requirements for creating a model evaluation job see, Model evaluations.

", + "CreateEvaluationJob": "

API operation for creating and managing Amazon Bedrock automatic model evaluation jobs and model evaluation jobs that use human workers. To learn more about the requirements for creating a model evaluation job see, Model evaluation.

", "CreateGuardrail": "

Creates a guardrail to block topics and to implement safeguards for your generative AI applications.

You can configure the following policies in a guardrail to avoid undesirable and harmful content, filter out denied topics and words, and remove sensitive information for privacy protection.

In addition to the above policies, you can also configure the messages to be returned to the user if a user input or model response is in violation of the policies defined in the guardrail.

For more information, see Guardrails for Amazon Bedrock in the Amazon Bedrock User Guide.

", "CreateGuardrailVersion": "

Creates a version of the guardrail. Use this API to create a snapshot of the guardrail when you are satisfied with a configuration, or to compare the configuration with another version.

", - "CreateModelCustomizationJob": "

Creates a fine-tuning job to customize a base model.

You specify the base foundation model and the location of the training data. After the model-customization job completes successfully, your custom model resource will be ready to use. Amazon Bedrock returns validation loss metrics and output generations after the job completes.

For information on the format of training and validation data, see Prepare the datasets.

Model-customization jobs are asynchronous and the completion time depends on the base model and the training/validation data size. To monitor a job, use the GetModelCustomizationJob operation to retrieve the job status.

For more information, see Custom models in the Amazon Bedrock User Guide.

", - "CreateProvisionedModelThroughput": "

Creates dedicated throughput for a base or custom model with the model units and for the duration that you specify. For pricing details, see Amazon Bedrock Pricing. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", - "DeleteCustomModel": "

Deletes a custom model that you created earlier. For more information, see Custom models in the Amazon Bedrock User Guide.

", + "CreateModelCopyJob": "

Copies a model to another region so that it can be used there. For more information, see Copy models to be used in other regions in the Amazon Bedrock User Guide.

", + "CreateModelCustomizationJob": "

Creates a fine-tuning job to customize a base model.

You specify the base foundation model and the location of the training data. After the model-customization job completes successfully, your custom model resource will be ready to use. Amazon Bedrock returns validation loss metrics and output generations after the job completes.

For information on the format of training and validation data, see Prepare the datasets.

Model-customization jobs are asynchronous and the completion time depends on the base model and the training/validation data size. To monitor a job, use the GetModelCustomizationJob operation to retrieve the job status.

For more information, see Custom models in the Amazon Bedrock User Guide.

", + "CreateProvisionedModelThroughput": "

Creates dedicated throughput for a base or custom model with the model units and for the duration that you specify. For pricing details, see Amazon Bedrock Pricing. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", + "DeleteCustomModel": "

Deletes a custom model that you created earlier. For more information, see Custom models in the Amazon Bedrock User Guide.

", "DeleteGuardrail": "

Deletes a guardrail.

", "DeleteModelInvocationLoggingConfiguration": "

Delete the invocation logging.

", - "DeleteProvisionedModelThroughput": "

Deletes a Provisioned Throughput. You can't delete a Provisioned Throughput before the commitment term is over. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", - "GetCustomModel": "

Get the properties associated with a Amazon Bedrock custom model that you have created.For more information, see Custom models in the Amazon Bedrock User Guide.

", - "GetEvaluationJob": "

Retrieves the properties associated with a model evaluation job, including the status of the job. For more information, see Model evaluations.

", + "DeleteProvisionedModelThroughput": "

Deletes a Provisioned Throughput. You can't delete a Provisioned Throughput before the commitment term is over. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", + "GetCustomModel": "

Get the properties associated with a Amazon Bedrock custom model that you have created.For more information, see Custom models in the Amazon Bedrock User Guide.

", + "GetEvaluationJob": "

Retrieves the properties associated with a model evaluation job, including the status of the job. For more information, see Model evaluation.

", "GetFoundationModel": "

Get details about a Amazon Bedrock foundation model.

", "GetGuardrail": "

Gets details about a guardrail. If you don't specify a version, the response returns details for the DRAFT version.

", - "GetModelCustomizationJob": "

Retrieves the properties associated with a model-customization job, including the status of the job. For more information, see Custom models in the Amazon Bedrock User Guide.

", + "GetModelCopyJob": "

Retrieves information about a model copy job. For more information, see Copy models to be used in other regions in the Amazon Bedrock User Guide.

", + "GetModelCustomizationJob": "

Retrieves the properties associated with a model-customization job, including the status of the job. For more information, see Custom models in the Amazon Bedrock User Guide.

", "GetModelInvocationLoggingConfiguration": "

Get the current configuration values for model invocation logging.

", - "GetProvisionedModelThroughput": "

Returns details for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", - "ListCustomModels": "

Returns a list of the custom models that you have created with the CreateModelCustomizationJob operation.

For more information, see Custom models in the Amazon Bedrock User Guide.

", + "GetProvisionedModelThroughput": "

Returns details for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", + "ListCustomModels": "

Returns a list of the custom models that you have created with the CreateModelCustomizationJob operation.

For more information, see Custom models in the Amazon Bedrock User Guide.

", "ListEvaluationJobs": "

Lists model evaluation jobs.

", - "ListFoundationModels": "

Lists Amazon Bedrock foundation models that you can use. You can filter the results with the request parameters. For more information, see Foundation models in the Amazon Bedrock User Guide.

", + "ListFoundationModels": "

Lists Amazon Bedrock foundation models that you can use. You can filter the results with the request parameters. For more information, see Foundation models in the Amazon Bedrock User Guide.

", "ListGuardrails": "

Lists details about all the guardrails in an account. To list the DRAFT version of all your guardrails, don't specify the guardrailIdentifier field. To list all versions of a guardrail, specify the ARN of the guardrail in the guardrailIdentifier field.

You can set the maximum number of results to return in a response in the maxResults field. If there are more results than the number you set, the response returns a nextToken that you can send in another ListGuardrails request to see the next batch of results.

", - "ListModelCustomizationJobs": "

Returns a list of model customization jobs that you have submitted. You can filter the jobs to return based on one or more criteria.

For more information, see Custom models in the Amazon Bedrock User Guide.

", - "ListProvisionedModelThroughputs": "

Lists the Provisioned Throughputs in the account. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", - "ListTagsForResource": "

List the tags associated with the specified resource.

For more information, see Tagging resources in the Amazon Bedrock User Guide.

", + "ListModelCopyJobs": "

Returns a list of model copy jobs that you have submitted. You can filter the jobs to return based on one or more criteria. For more information, see Copy models to be used in other regions in the Amazon Bedrock User Guide.

", + "ListModelCustomizationJobs": "

Returns a list of model customization jobs that you have submitted. You can filter the jobs to return based on one or more criteria.

For more information, see Custom models in the Amazon Bedrock User Guide.

", + "ListProvisionedModelThroughputs": "

Lists the Provisioned Throughputs in the account. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

", + "ListTagsForResource": "

List the tags associated with the specified resource.

For more information, see Tagging resources in the Amazon Bedrock User Guide.

", "PutModelInvocationLoggingConfiguration": "

Set the configuration values for model invocation logging.

", "StopEvaluationJob": "

Stops an in progress model evaluation job.

", - "StopModelCustomizationJob": "

Stops an active model customization job. For more information, see Custom models in the Amazon Bedrock User Guide.

", - "TagResource": "

Associate tags with a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.

", - "UntagResource": "

Remove one or more tags from a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.

", + "StopModelCustomizationJob": "

Stops an active model customization job. For more information, see Custom models in the Amazon Bedrock User Guide.

", + "TagResource": "

Associate tags with a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.

", + "UntagResource": "

Remove one or more tags from a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.

", "UpdateGuardrail": "

Updates a guardrail with the values you specify.

", - "UpdateProvisionedModelThroughput": "

Updates the name or associated model for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

" + "UpdateProvisionedModelThroughput": "

Updates the name or associated model for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

" }, "shapes": { "AccessDeniedException": { @@ -39,6 +42,15 @@ "refs": { } }, + "AccountId": { + "base": null, + "refs": { + "CustomModelSummary$ownerAccountId": "

The unique identifier of the account that owns the model.

", + "GetModelCopyJobResponse$sourceAccountId": "

The unique identifier of the account that the model being copied originated from.

", + "ListModelCopyJobsRequest$sourceAccountEquals": "

Filters for model copy jobs in which the account that the source model belongs to is equal to the value that you specify.

", + "ModelCopyJobSummary$sourceAccountId": "

The unique identifier of the account that the model being copied originated from.

" + } + }, "AutomatedEvaluationConfig": { "base": "

Use to specify a automatic model evaluation job. The EvaluationDatasetMetricConfig object is used to specify the prompt datasets, task type, and metric names.

", "refs": { @@ -63,6 +75,7 @@ "refs": { "FoundationModelDetails$responseStreamingSupported": "

Indicates whether the model supports streaming.

", "FoundationModelSummary$responseStreamingSupported": "

Indicates whether the model supports streaming.

", + "ListCustomModelsRequest$isOwned": "

Return custom models depending on if the current account owns them (true) or if they were shared with the current account (false).

", "LoggingConfig$textDataDeliveryEnabled": "

Set to include text data in the log delivery.

", "LoggingConfig$imageDataDeliveryEnabled": "

Set to include image data in the log delivery.

", "LoggingConfig$embeddingDataDeliveryEnabled": "

Set to include embeddings data in the log delivery.

" @@ -92,7 +105,7 @@ "CommitmentDuration": { "base": null, "refs": { - "CreateProvisionedModelThroughputRequest$commitmentDuration": "

The commitment duration requested for the Provisioned Throughput. Billing occurs hourly and is discounted for longer commitment terms. To request a no-commit Provisioned Throughput, omit this field.

Custom models support all levels of commitment. To see which base models support no commitment, see Supported regions and models for Provisioned Throughput in the Amazon Bedrock User Guide

", + "CreateProvisionedModelThroughputRequest$commitmentDuration": "

The commitment duration requested for the Provisioned Throughput. Billing occurs hourly and is discounted for longer commitment terms. To request a no-commit Provisioned Throughput, omit this field.

Custom models support all levels of commitment. To see which base models support no commitment, see Supported regions and models for Provisioned Throughput in the Amazon Bedrock User Guide

", "GetProvisionedModelThroughputResponse$commitmentDuration": "

Commitment duration of the Provisioned Throughput.

", "ProvisionedModelSummary$commitmentDuration": "

The duration for which the Provisioned Throughput was committed.

" } @@ -132,6 +145,16 @@ "refs": { } }, + "CreateModelCopyJobRequest": { + "base": null, + "refs": { + } + }, + "CreateModelCopyJobResponse": { + "base": null, + "refs": { + } + }, "CreateModelCustomizationJobRequest": { "base": null, "refs": { @@ -156,18 +179,26 @@ "base": null, "refs": { "CustomModelSummary$modelArn": "

The Amazon Resource Name (ARN) of the custom model.

", + "GetModelCopyJobResponse$targetModelArn": "

The Amazon Resource Name (ARN) of the copied model.

", "GetModelCustomizationJobResponse$outputModelArn": "

The Amazon Resource Name (ARN) of the output model.

", + "ModelCopyJobSummary$targetModelArn": "

The Amazon Resource Name (ARN) of the copied model.

", "ModelCustomizationJobSummary$customModelArn": "

Amazon Resource Name (ARN) of the custom model.

" } }, "CustomModelName": { "base": null, "refs": { + "CreateModelCopyJobRequest$targetModelName": "

A name for the copied model.

", "CreateModelCustomizationJobRequest$customModelName": "

A name for the resulting custom model.

", "CustomModelSummary$modelName": "

The name of the custom model.

", "GetCustomModelResponse$modelName": "

Model name associated with this model.

", + "GetModelCopyJobResponse$targetModelName": "

The name of the copied model.

", + "GetModelCopyJobResponse$sourceModelName": "

The name of the original model being copied.

", "GetModelCustomizationJobResponse$outputModelName": "

The name of the output model.

", "ListCustomModelsRequest$nameContains": "

Return custom models only if the job name contains these characters.

", + "ListModelCopyJobsRequest$targetModelNameContains": "

Filters for model copy jobs in which the name of the copied model contains the string that you specify.

", + "ModelCopyJobSummary$targetModelName": "

The name of the copied model.

", + "ModelCopyJobSummary$sourceModelName": "

The name of the original model being copied.

", "ModelCustomizationJobSummary$customModelName": "

Name of the custom model.

" } }, @@ -237,8 +268,10 @@ "base": null, "refs": { "ErrorMessages$member": null, + "GetModelCopyJobResponse$failureMessage": "

An error message for why the model copy job failed.

", "GetModelCustomizationJobResponse$failureMessage": "

Information about why the job failed.

", - "GetProvisionedModelThroughputResponse$failureMessage": "

A failure message for any issues that occurred during creation, updating, or deletion of the Provisioned Throughput.

" + "GetProvisionedModelThroughputResponse$failureMessage": "

A failure message for any issues that occurred during creation, updating, or deletion of the Provisioned Throughput.

", + "ModelCopyJobSummary$failureMessage": "

If a model fails to be copied, a message describing why the job failed is included here.

" } }, "ErrorMessages": { @@ -520,6 +553,16 @@ "refs": { } }, + "GetModelCopyJobRequest": { + "base": null, + "refs": { + } + }, + "GetModelCopyJobResponse": { + "base": null, + "refs": { + } + }, "GetModelCustomizationJobRequest": { "base": null, "refs": { @@ -802,7 +845,7 @@ "GuardrailPiiEntityType": { "base": null, "refs": { - "GuardrailPiiEntity$type": "

The type of PII entity. For example, Social Security Number.

", + "GuardrailPiiEntity$type": "

The type of PII entity. For exampvle, Social Security Number.

", "GuardrailPiiEntityConfig$type": "

Configure guardrail type when the PII entity is detected.

The following PIIs are used to block or mask sensitive information:

" } }, @@ -1083,6 +1126,7 @@ "CreateEvaluationJobRequest$clientRequestToken": "

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency.

", "CreateGuardrailRequest$clientRequestToken": "

A unique, case-sensitive identifier to ensure that the API request completes no more than once. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency in the Amazon S3 User Guide.

", "CreateGuardrailVersionRequest$clientRequestToken": "

A unique, case-sensitive identifier to ensure that the API request completes no more than once. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency in the Amazon S3 User Guide.

", + "CreateModelCopyJobRequest$clientRequestToken": "

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency.

", "CreateModelCustomizationJobRequest$clientRequestToken": "

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency.

", "CreateProvisionedModelThroughputRequest$clientRequestToken": "

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency in the Amazon S3 User Guide.

", "GetModelCustomizationJobResponse$clientRequestToken": "

The token that you specified in the CreateCustomizationJob request.

" @@ -1092,7 +1136,7 @@ "base": null, "refs": { "InferenceTypeList$member": null, - "ListFoundationModelsRequest$byInferenceType": "

Return models that support the inference type that you specify. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

" + "ListFoundationModelsRequest$byInferenceType": "

Return models that support the inference type that you specify. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.

" } }, "InferenceTypeList": { @@ -1128,7 +1172,9 @@ "refs": { "GetCustomModelResponse$modelKmsKeyArn": "

The custom model is encrypted at rest using this key.

", "GetGuardrailResponse$kmsKeyArn": "

The ARN of the KMS key that encrypts the guardrail.

", - "GetModelCustomizationJobResponse$outputModelKmsKeyArn": "

The custom model is encrypted at rest using this key.

" + "GetModelCopyJobResponse$targetModelKmsKeyArn": "

The Amazon Resource Name (ARN) of the KMS key encrypting the copied model.

", + "GetModelCustomizationJobResponse$outputModelKmsKeyArn": "

The custom model is encrypted at rest using this key.

", + "ModelCopyJobSummary$targetModelKmsKeyArn": "

The Amazon Resource Name (ARN) of the KMS key used to encrypt the copied model.

" } }, "KmsKeyId": { @@ -1136,6 +1182,7 @@ "refs": { "CreateEvaluationJobRequest$customerEncryptionKeyId": "

Specify your customer managed key ARN that will be used to encrypt your model evaluation job.

", "CreateGuardrailRequest$kmsKeyId": "

The ARN of the KMS key that you use to encrypt the guardrail.

", + "CreateModelCopyJobRequest$modelKmsKeyId": "

The ARN of the KMS key that you use to encrypt the model copy.

", "CreateModelCustomizationJobRequest$customModelKmsKeyId": "

The custom model is encrypted at rest using this key.

", "GetEvaluationJobResponse$customerEncryptionKeyId": "

The Amazon Resource Name (ARN) of the customer managed key specified when the model evaluation job was created.

", "UpdateGuardrailRequest$kmsKeyId": "

The ARN of the KMS key with which to encrypt the guardrail.

" @@ -1181,6 +1228,16 @@ "refs": { } }, + "ListModelCopyJobsRequest": { + "base": null, + "refs": { + } + }, + "ListModelCopyJobsResponse": { + "base": null, + "refs": { + } + }, "ListModelCustomizationJobsRequest": { "base": null, "refs": { @@ -1227,10 +1284,11 @@ "MaxResults": { "base": null, "refs": { - "ListCustomModelsRequest$maxResults": "

Maximum number of results to return in the response.

", + "ListCustomModelsRequest$maxResults": "

The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the nextToken field when making another request to return the next batch of results.

", "ListEvaluationJobsRequest$maxResults": "

The maximum number of results to return.

", "ListGuardrailsRequest$maxResults": "

The maximum number of results to return in the response.

", - "ListModelCustomizationJobsRequest$maxResults": "

Maximum number of results to return in the response.

", + "ListModelCopyJobsRequest$maxResults": "

The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the nextToken field when making another request to return the next batch of results.

", + "ListModelCustomizationJobsRequest$maxResults": "

The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the nextToken field when making another request to return the next batch of results.

", "ListProvisionedModelThroughputsRequest$maxResults": "

THe maximum number of results to return in the response. If there are more results than the number you specified, the response returns a nextToken value. To see the next batch of results, send the nextToken value in another list request.

" } }, @@ -1244,22 +1302,55 @@ "ModelArn": { "base": null, "refs": { + "CreateModelCopyJobRequest$sourceModelArn": "

The Amazon Resource Name (ARN) of the model to be copied.

", "CustomModelSummary$baseModelArn": "

The base model Amazon Resource Name (ARN).

", "GetCustomModelResponse$modelArn": "

Amazon Resource Name (ARN) associated with this model.

", "GetCustomModelResponse$baseModelArn": "

Amazon Resource Name (ARN) of the base model.

", + "GetModelCopyJobResponse$sourceModelArn": "

The Amazon Resource Name (ARN) of the original model being copied.

", "GetProvisionedModelThroughputResponse$modelArn": "

The Amazon Resource Name (ARN) of the model associated with this Provisioned Throughput.

", "GetProvisionedModelThroughputResponse$desiredModelArn": "

The Amazon Resource Name (ARN) of the model requested to be associated to this Provisioned Throughput. This value differs from the modelArn if updating hasn't completed.

", "ListCustomModelsRequest$baseModelArnEquals": "

Return custom models only if the base model Amazon Resource Name (ARN) matches this parameter.

", + "ListModelCopyJobsRequest$sourceModelArnEquals": "

Filters for model copy jobs in which the Amazon Resource Name (ARN) of the source model to is equal to the value that you specify.

", "ListProvisionedModelThroughputsRequest$modelArnEquals": "

A filter that returns Provisioned Throughputs whose model Amazon Resource Name (ARN) is equal to the value that you specify.

", + "ModelCopyJobSummary$sourceModelArn": "

The Amazon Resource Name (ARN) of the original model being copied.

", "ModelCustomizationJobSummary$baseModelArn": "

Amazon Resource Name (ARN) of the base model.

", "ProvisionedModelSummary$modelArn": "

The Amazon Resource Name (ARN) of the model associated with the Provisioned Throughput.

", "ProvisionedModelSummary$desiredModelArn": "

The Amazon Resource Name (ARN) of the model requested to be associated to this Provisioned Throughput. This value differs from the modelArn if updating hasn't completed.

" } }, + "ModelCopyJobArn": { + "base": null, + "refs": { + "CreateModelCopyJobResponse$jobArn": "

The Amazon Resource Name (ARN) of the model copy job.

", + "GetModelCopyJobRequest$jobArn": "

The Amazon Resource Name (ARN) of the model copy job.

", + "GetModelCopyJobResponse$jobArn": "

The Amazon Resource Name (ARN) of the model copy job.

", + "ModelCopyJobSummary$jobArn": "

The Amazon Resoource Name (ARN) of the model copy job.

" + } + }, + "ModelCopyJobStatus": { + "base": null, + "refs": { + "GetModelCopyJobResponse$status": "

The status of the model copy job.

", + "ListModelCopyJobsRequest$statusEquals": "

Filters for model copy jobs whose status matches the value that you specify.

", + "ModelCopyJobSummary$status": "

The status of the model copy job.

" + } + }, + "ModelCopyJobSummaries": { + "base": null, + "refs": { + "ListModelCopyJobsResponse$modelCopyJobSummaries": "

A list of information about each model copy job.

" + } + }, + "ModelCopyJobSummary": { + "base": "

Contains details about each model copy job.

This data type is used in the following API operations:

", + "refs": { + "ModelCopyJobSummaries$member": null + } + }, "ModelCustomization": { "base": null, "refs": { - "ListFoundationModelsRequest$byCustomizationType": "

Return models that support the customization type that you specify. For more information, see Custom models in the Amazon Bedrock User Guide.

", + "ListFoundationModelsRequest$byCustomizationType": "

Return models that support the customization type that you specify. For more information, see Custom models in the Amazon Bedrock User Guide.

", "ModelCustomizationList$member": null } }, @@ -1316,7 +1407,7 @@ "ModelIdentifier": { "base": null, "refs": { - "CreateProvisionedModelThroughputRequest$modelId": "

The Amazon Resource Name (ARN) or name of the model to associate with this Provisioned Throughput. For a list of models for which you can purchase Provisioned Throughput, see Amazon Bedrock model IDs for purchasing Provisioned Throughput in the Amazon Bedrock User Guide.

", + "CreateProvisionedModelThroughputRequest$modelId": "

The Amazon Resource Name (ARN) or name of the model to associate with this Provisioned Throughput. For a list of models for which you can purchase Provisioned Throughput, see Amazon Bedrock model IDs for purchasing Provisioned Throughput in the Amazon Bedrock User Guide.

", "DeleteCustomModelRequest$modelIdentifier": "

Name of the model to delete.

", "GetCustomModelRequest$modelIdentifier": "

Name or Amazon Resource Name (ARN) of the custom model.

", "GetFoundationModelRequest$modelIdentifier": "

The model identifier.

", @@ -1369,14 +1460,16 @@ "PaginationToken": { "base": null, "refs": { - "ListCustomModelsRequest$nextToken": "

Continuation token from the previous response, for Amazon Bedrock to list the next set of results.

", - "ListCustomModelsResponse$nextToken": "

Continuation token for the next request to list the next set of results.

", + "ListCustomModelsRequest$nextToken": "

If the total number of results is greater than the maxResults value provided in the request, enter the token returned in the nextToken field in the response in this field to return the next batch of results.

", + "ListCustomModelsResponse$nextToken": "

If the total number of results is greater than the maxResults value provided in the request, use this token when making another request in the nextToken field to return the next batch of results.

", "ListEvaluationJobsRequest$nextToken": "

Continuation token from the previous response, for Amazon Bedrock to list the next set of results.

", "ListEvaluationJobsResponse$nextToken": "

Continuation token from the previous response, for Amazon Bedrock to list the next set of results.

", "ListGuardrailsRequest$nextToken": "

If there are more results than were returned in the response, the response returns a nextToken that you can send in another ListGuardrails request to see the next batch of results.

", "ListGuardrailsResponse$nextToken": "

If there are more results than were returned in the response, the response returns a nextToken that you can send in another ListGuardrails request to see the next batch of results.

", - "ListModelCustomizationJobsRequest$nextToken": "

Continuation token from the previous response, for Amazon Bedrock to list the next set of results.

", - "ListModelCustomizationJobsResponse$nextToken": "

Page continuation token to use in the next request.

", + "ListModelCopyJobsRequest$nextToken": "

If the total number of results is greater than the maxResults value provided in the request, enter the token returned in the nextToken field in the response in this field to return the next batch of results.

", + "ListModelCopyJobsResponse$nextToken": "

If the total number of results is greater than the maxResults value provided in the request, use this token when making another request in the nextToken field to return the next batch of results.

", + "ListModelCustomizationJobsRequest$nextToken": "

If the total number of results is greater than the maxResults value provided in the request, enter the token returned in the nextToken field in the response in this field to return the next batch of results.

", + "ListModelCustomizationJobsResponse$nextToken": "

If the total number of results is greater than the maxResults value provided in the request, use this token when making another request in the nextToken field to return the next batch of results.

", "ListProvisionedModelThroughputsRequest$nextToken": "

If there are more results than the number you specified in the maxResults field, the response returns a nextToken value. To see the next batch of results, specify the nextToken value in this field.

", "ListProvisionedModelThroughputsResponse$nextToken": "

If there are more results than the number you specified in the maxResults field, this value is returned. To see the next batch of results, include this value in the nextToken field in another list request.

" } @@ -1384,7 +1477,7 @@ "PositiveInteger": { "base": null, "refs": { - "CreateProvisionedModelThroughputRequest$modelUnits": "

Number of model units to allocate. A model unit delivers a specific throughput level for the specified model. The throughput level of a model unit specifies the total number of input and output tokens that it can process and generate within a span of one minute. By default, your account has no model units for purchasing Provisioned Throughputs with commitment. You must first visit the Amazon Web Services support center to request MUs.

For model unit quotas, see Provisioned Throughput quotas in the Amazon Bedrock User Guide.

For more information about what an MU specifies, contact your Amazon Web Services account manager.

", + "CreateProvisionedModelThroughputRequest$modelUnits": "

Number of model units to allocate. A model unit delivers a specific throughput level for the specified model. The throughput level of a model unit specifies the total number of input and output tokens that it can process and generate within a span of one minute. By default, your account has no model units for purchasing Provisioned Throughputs with commitment. You must first visit the Amazon Web Services support center to request MUs.

For model unit quotas, see Provisioned Throughput quotas in the Amazon Bedrock User Guide.

For more information about what an MU specifies, contact your Amazon Web Services account manager.

", "GetProvisionedModelThroughputResponse$modelUnits": "

The number of model units allocated to this Provisioned Throughput.

", "GetProvisionedModelThroughputResponse$desiredModelUnits": "

The number of model units that was requested for this Provisioned Throughput.

", "ProvisionedModelSummary$modelUnits": "

The number of model units allocated to the Provisioned Throughput.

", @@ -1518,6 +1611,7 @@ "base": null, "refs": { "ListEvaluationJobsRequest$sortBy": "

Allows you to sort model evaluation jobs by when they were created.

", + "ListModelCopyJobsRequest$sortBy": "

The field to sort by in the returned list of model copy jobs.

", "ListModelCustomizationJobsRequest$sortBy": "

The field to sort by in the returned list of jobs.

" } }, @@ -1532,6 +1626,7 @@ "refs": { "ListCustomModelsRequest$sortOrder": "

The sort order of the results.

", "ListEvaluationJobsRequest$sortOrder": "

How you want the order of jobs sorted.

", + "ListModelCopyJobsRequest$sortOrder": "

Specifies whether to sort the results in ascending or descending order.

", "ListModelCustomizationJobsRequest$sortOrder": "

The sort order of the results.

", "ListProvisionedModelThroughputsRequest$sortOrder": "

The sort order of the results.

" } @@ -1599,10 +1694,13 @@ "refs": { "CreateEvaluationJobRequest$jobTags": "

Tags to attach to the model evaluation job.

", "CreateGuardrailRequest$tags": "

The tags that you want to attach to the guardrail.

", + "CreateModelCopyJobRequest$targetModelTags": "

Tags to associate with the target model. For more information, see Tag resources in the Amazon Bedrock User Guide.

", "CreateModelCustomizationJobRequest$jobTags": "

Tags to attach to the job.

", "CreateModelCustomizationJobRequest$customModelTags": "

Tags to attach to the resulting custom model.

", "CreateProvisionedModelThroughputRequest$tags": "

Tags to associate with this Provisioned Throughput.

", + "GetModelCopyJobResponse$targetModelTags": "

The tags associated with the copied model.

", "ListTagsForResourceResponse$tags": "

An array of the tags associated with this resource.

", + "ModelCopyJobSummary$targetModelTags": "

Tags associated with the copied model.

", "TagResourceRequest$tags": "

Tags to associate with the resource.

" } }, @@ -1647,6 +1745,7 @@ "GetEvaluationJobResponse$lastModifiedTime": "

When the model evaluation job was last modified.

", "GetGuardrailResponse$createdAt": "

The date and time at which the guardrail was created.

", "GetGuardrailResponse$updatedAt": "

The date and time at which the guardrail was updated.

", + "GetModelCopyJobResponse$creationTime": "

The time at which the model copy job was created.

", "GetModelCustomizationJobResponse$creationTime": "

Time that the resource was created.

", "GetModelCustomizationJobResponse$lastModifiedTime": "

Time that the resource was last modified.

", "GetModelCustomizationJobResponse$endTime": "

Time that the resource transitioned to terminal state.

", @@ -1659,10 +1758,13 @@ "ListCustomModelsRequest$creationTimeAfter": "

Return custom models created after the specified time.

", "ListEvaluationJobsRequest$creationTimeAfter": "

A filter that includes model evaluation jobs created after the time specified.

", "ListEvaluationJobsRequest$creationTimeBefore": "

A filter that includes model evaluation jobs created prior to the time specified.

", + "ListModelCopyJobsRequest$creationTimeAfter": "

Filters for model copy jobs created after the specified time.

", + "ListModelCopyJobsRequest$creationTimeBefore": "

Filters for model copy jobs created before the specified time.

", "ListModelCustomizationJobsRequest$creationTimeAfter": "

Return customization jobs created after the specified time.

", "ListModelCustomizationJobsRequest$creationTimeBefore": "

Return customization jobs created before the specified time.

", "ListProvisionedModelThroughputsRequest$creationTimeAfter": "

A filter that returns Provisioned Throughputs created after the specified time.

", "ListProvisionedModelThroughputsRequest$creationTimeBefore": "

A filter that returns Provisioned Throughputs created before the specified time.

", + "ModelCopyJobSummary$creationTime": "

The time that the model copy job was created.

", "ModelCustomizationJobSummary$lastModifiedTime": "

Time that the customization job was last modified.

", "ModelCustomizationJobSummary$creationTime": "

Creation time of the custom model.

", "ModelCustomizationJobSummary$endTime": "

Time that the customization job ended.

", diff --git a/apis/bedrock/2023-04-20/paginators-1.json b/apis/bedrock/2023-04-20/paginators-1.json index 8f920eff6d1..2794ae44e7f 100644 --- a/apis/bedrock/2023-04-20/paginators-1.json +++ b/apis/bedrock/2023-04-20/paginators-1.json @@ -18,6 +18,12 @@ "limit_key": "maxResults", "result_key": "guardrails" }, + "ListModelCopyJobs": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "modelCopyJobSummaries" + }, "ListModelCustomizationJobs": { "input_token": "nextToken", "output_token": "nextToken", diff --git a/apis/controlcatalog/2018-05-10/api-2.json b/apis/controlcatalog/2018-05-10/api-2.json index cd89c8a5aa0..0a2097c0e6a 100644 --- a/apis/controlcatalog/2018-05-10/api-2.json +++ b/apis/controlcatalog/2018-05-10/api-2.json @@ -2,9 +2,10 @@ "version":"2.0", "metadata":{ "apiVersion":"2018-05-10", + "auth":["aws.auth#sigv4"], "endpointPrefix":"controlcatalog", - "jsonVersion":"1.1", "protocol":"rest-json", + "protocols":["rest-json"], "serviceFullName":"AWS Control Catalog", "serviceId":"ControlCatalog", "signatureVersion":"v4", @@ -12,6 +13,23 @@ "uid":"controlcatalog-2018-05-10" }, "operations":{ + "GetControl":{ + "name":"GetControl", + "http":{ + "method":"POST", + "requestUri":"/get-control", + "responseCode":200 + }, + "input":{"shape":"GetControlRequest"}, + "output":{"shape":"GetControlResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InternalServerException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ] + }, "ListCommonControls":{ "name":"ListCommonControls", "http":{ @@ -28,6 +46,22 @@ {"shape":"ThrottlingException"} ] }, + "ListControls":{ + "name":"ListControls", + "http":{ + "method":"POST", + "requestUri":"/list-controls", + "responseCode":200 + }, + "input":{"shape":"ListControlsRequest"}, + "output":{"shape":"ListControlsResponse"}, + "errors":[ + {"shape":"AccessDeniedException"}, + {"shape":"InternalServerException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ] + }, "ListDomains":{ "name":"ListDomains", "http":{ @@ -91,7 +125,7 @@ "type":"string", "max":2048, "min":41, - "pattern":"^arn:(aws(?:[-a-z]*)?):controlcatalog:::common-control/[0-9a-z]+$" + "pattern":"arn:(aws(?:[-a-z]*)?):controlcatalog:::common-control/[0-9a-z]+" }, "CommonControlFilter":{ "type":"structure", @@ -103,32 +137,74 @@ "type":"structure", "required":[ "Arn", - "CreateTime", + "Name", "Description", "Domain", - "LastUpdateTime", - "Name", - "Objective" + "Objective", + "CreateTime", + "LastUpdateTime" ], "members":{ "Arn":{"shape":"CommonControlArn"}, - "CreateTime":{"shape":"Timestamp"}, + "Name":{"shape":"String"}, "Description":{"shape":"String"}, "Domain":{"shape":"AssociatedDomainSummary"}, - "LastUpdateTime":{"shape":"Timestamp"}, - "Name":{"shape":"String"}, - "Objective":{"shape":"AssociatedObjectiveSummary"} + "Objective":{"shape":"AssociatedObjectiveSummary"}, + "CreateTime":{"shape":"Timestamp"}, + "LastUpdateTime":{"shape":"Timestamp"} } }, "CommonControlSummaryList":{ "type":"list", "member":{"shape":"CommonControlSummary"} }, + "ControlArn":{ + "type":"string", + "max":2048, + "min":34, + "pattern":"arn:(aws(?:[-a-z]*)?):(controlcatalog|controltower):[a-zA-Z0-9-]*::control/[0-9a-zA-Z_\\-]+" + }, + "ControlBehavior":{ + "type":"string", + "enum":[ + "PREVENTIVE", + "PROACTIVE", + "DETECTIVE" + ] + }, + "ControlScope":{ + "type":"string", + "enum":[ + "GLOBAL", + "REGIONAL" + ] + }, + "ControlSummary":{ + "type":"structure", + "required":[ + "Arn", + "Name", + "Description" + ], + "members":{ + "Arn":{"shape":"ControlArn"}, + "Name":{"shape":"String"}, + "Description":{"shape":"String"} + } + }, + "Controls":{ + "type":"list", + "member":{"shape":"ControlSummary"} + }, + "DeployableRegions":{ + "type":"list", + "member":{"shape":"RegionCode"} + }, "DomainArn":{ "type":"string", "max":2048, "min":33, - "pattern":"^arn:(aws(?:[-a-z]*)?):controlcatalog:::domain/[0-9a-z]+$" + "pattern":"arn:(aws(?:[-a-z]*)?):controlcatalog:::domain/[0-9a-z]+" }, "DomainResourceFilter":{ "type":"structure", @@ -144,23 +220,47 @@ "type":"structure", "required":[ "Arn", - "CreateTime", + "Name", "Description", - "LastUpdateTime", - "Name" + "CreateTime", + "LastUpdateTime" ], "members":{ "Arn":{"shape":"DomainArn"}, - "CreateTime":{"shape":"Timestamp"}, + "Name":{"shape":"String"}, "Description":{"shape":"String"}, - "LastUpdateTime":{"shape":"Timestamp"}, - "Name":{"shape":"String"} + "CreateTime":{"shape":"Timestamp"}, + "LastUpdateTime":{"shape":"Timestamp"} } }, "DomainSummaryList":{ "type":"list", "member":{"shape":"DomainSummary"} }, + "GetControlRequest":{ + "type":"structure", + "required":["ControlArn"], + "members":{ + "ControlArn":{"shape":"ControlArn"} + } + }, + "GetControlResponse":{ + "type":"structure", + "required":[ + "Arn", + "Name", + "Description", + "Behavior", + "RegionConfiguration" + ], + "members":{ + "Arn":{"shape":"ControlArn"}, + "Name":{"shape":"String"}, + "Description":{"shape":"String"}, + "Behavior":{"shape":"ControlBehavior"}, + "RegionConfiguration":{"shape":"RegionConfiguration"} + } + }, "InternalServerException":{ "type":"structure", "members":{ @@ -174,7 +274,6 @@ "ListCommonControlsRequest":{ "type":"structure", "members":{ - "CommonControlFilter":{"shape":"CommonControlFilter"}, "MaxResults":{ "shape":"MaxListCommonControlsResults", "location":"querystring", @@ -184,7 +283,8 @@ "shape":"PaginationToken", "location":"querystring", "locationName":"nextToken" - } + }, + "CommonControlFilter":{"shape":"CommonControlFilter"} } }, "ListCommonControlsResponse":{ @@ -195,6 +295,29 @@ "NextToken":{"shape":"PaginationToken"} } }, + "ListControlsRequest":{ + "type":"structure", + "members":{ + "NextToken":{ + "shape":"PaginationToken", + "location":"querystring", + "locationName":"nextToken" + }, + "MaxResults":{ + "shape":"MaxListControlsResults", + "location":"querystring", + "locationName":"maxResults" + } + } + }, + "ListControlsResponse":{ + "type":"structure", + "required":["Controls"], + "members":{ + "Controls":{"shape":"Controls"}, + "NextToken":{"shape":"PaginationToken"} + } + }, "ListDomainsRequest":{ "type":"structure", "members":{ @@ -238,8 +361,8 @@ "type":"structure", "required":["Objectives"], "members":{ - "NextToken":{"shape":"PaginationToken"}, - "Objectives":{"shape":"ObjectiveSummaryList"} + "Objectives":{"shape":"ObjectiveSummaryList"}, + "NextToken":{"shape":"PaginationToken"} } }, "MaxListCommonControlsResults":{ @@ -248,6 +371,12 @@ "max":100, "min":1 }, + "MaxListControlsResults":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, "MaxListDomainsResults":{ "type":"integer", "box":true, @@ -264,7 +393,7 @@ "type":"string", "max":2048, "min":36, - "pattern":"^arn:(aws(?:[-a-z]*)?):controlcatalog:::objective/[0-9a-z]+$" + "pattern":"arn:(aws(?:[-a-z]*)?):controlcatalog:::objective/[0-9a-z]+" }, "ObjectiveFilter":{ "type":"structure", @@ -286,19 +415,19 @@ "type":"structure", "required":[ "Arn", - "CreateTime", + "Name", "Description", "Domain", - "LastUpdateTime", - "Name" + "CreateTime", + "LastUpdateTime" ], "members":{ "Arn":{"shape":"ObjectiveArn"}, - "CreateTime":{"shape":"Timestamp"}, + "Name":{"shape":"String"}, "Description":{"shape":"String"}, "Domain":{"shape":"AssociatedDomainSummary"}, - "LastUpdateTime":{"shape":"Timestamp"}, - "Name":{"shape":"String"} + "CreateTime":{"shape":"Timestamp"}, + "LastUpdateTime":{"shape":"Timestamp"} } }, "ObjectiveSummaryList":{ @@ -310,6 +439,29 @@ "max":1024, "min":0 }, + "RegionCode":{ + "type":"string", + "pattern":"[a-zA-Z0-9-]{1,128}" + }, + "RegionConfiguration":{ + "type":"structure", + "required":["Scope"], + "members":{ + "Scope":{"shape":"ControlScope"}, + "DeployableRegions":{"shape":"DeployableRegions"} + } + }, + "ResourceNotFoundException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "error":{ + "httpStatusCode":404, + "senderFault":true + }, + "exception":true + }, "String":{"type":"string"}, "ThrottlingException":{ "type":"structure", diff --git a/apis/controlcatalog/2018-05-10/docs-2.json b/apis/controlcatalog/2018-05-10/docs-2.json index 149750a8042..3d0519dfe63 100644 --- a/apis/controlcatalog/2018-05-10/docs-2.json +++ b/apis/controlcatalog/2018-05-10/docs-2.json @@ -2,7 +2,9 @@ "version": "2.0", "service": "

Welcome to the Amazon Web Services Control Catalog API reference. This guide is for developers who need detailed information about how to programmatically identify and filter the common controls and related metadata that are available to Amazon Web Services customers. This API reference provides descriptions, syntax, and usage examples for each of the actions and data types that are supported by Amazon Web Services Control Catalog.

Use the following links to get started with the Amazon Web Services Control Catalog API:

", "operations": { + "GetControl": "

Returns details about a specific control, most notably a list of Amazon Web Services Regions where this control is supported. Input a value for the ControlArn parameter, in ARN form. GetControl accepts controltower or controlcatalog control ARNs as input. Returns a controlcatalog ARN format.

In the API response, controls that have the value GLOBAL in the Scope field do not show the DeployableRegions field, because it does not apply. Controls that have the value REGIONAL in the Scope field return a value for the DeployableRegions field, as shown in the example.

", "ListCommonControls": "

Returns a paginated list of common controls from the Amazon Web Services Control Catalog.

You can apply an optional filter to see common controls that have a specific objective. If you don’t provide a filter, the operation returns all common controls.

", + "ListControls": "

Returns a paginated list of all available controls in the Amazon Web Services Control Catalog library. Allows you to discover available controls. The list of controls is given as structures of type controlSummary. The ARN is returned in the global controlcatalog format, as shown in the examples.

", "ListDomains": "

Returns a paginated list of domains from the Amazon Web Services Control Catalog.

", "ListObjectives": "

Returns a paginated list of objectives from the Amazon Web Services Control Catalog.

You can apply an optional filter to see the objectives that belong to a specific domain. If you don’t provide a filter, the operation returns all objectives.

" }, @@ -49,6 +51,44 @@ "ListCommonControlsResponse$CommonControls": "

The list of common controls that the ListCommonControls API returns.

" } }, + "ControlArn": { + "base": null, + "refs": { + "ControlSummary$Arn": "

The Amazon Resource Name (ARN) of the control.

", + "GetControlRequest$ControlArn": "

The Amazon Resource Name (ARN) of the control. It has one of the following formats:

Global format

arn:{PARTITION}:controlcatalog:::control/{CONTROL_CATALOG_OPAQUE_ID}

Or Regional format

arn:{PARTITION}:controltower:{REGION}::control/{CONTROL_TOWER_OPAQUE_ID}

Here is a more general pattern that covers Amazon Web Services Control Tower and Control Catalog ARNs:

^arn:(aws(?:[-a-z]*)?):(controlcatalog|controltower):[a-zA-Z0-9-]*::control/[0-9a-zA-Z_\\\\-]+$

", + "GetControlResponse$Arn": "

The Amazon Resource Name (ARN) of the control.

" + } + }, + "ControlBehavior": { + "base": null, + "refs": { + "GetControlResponse$Behavior": "

A term that identifies the control's functional behavior. One of Preventive, Deteictive, Proactive

" + } + }, + "ControlScope": { + "base": null, + "refs": { + "RegionConfiguration$Scope": "

The coverage of the control, if deployed. Scope is an enumerated type, with value Regional, or Global. A control with Global scope is effective in all Amazon Web Services Regions, regardless of the Region from which it is enabled, or to which it is deployed. A control implemented by an SCP is usually Global in scope. A control with Regional scope has operations that are restricted specifically to the Region from which it is enabled and to which it is deployed. Controls implemented by Config rules and CloudFormation hooks usually are Regional in scope. Security Hub controls usually are Regional in scope.

" + } + }, + "ControlSummary": { + "base": "

Overview of information about a control.

", + "refs": { + "Controls$member": null + } + }, + "Controls": { + "base": null, + "refs": { + "ListControlsResponse$Controls": "

Returns a list of controls, given as structures of type controlSummary.

" + } + }, + "DeployableRegions": { + "base": null, + "refs": { + "RegionConfiguration$DeployableRegions": "

Regions in which the control is available to be deployed.

" + } + }, "DomainArn": { "base": null, "refs": { @@ -81,6 +121,16 @@ "ListDomainsResponse$Domains": "

The list of domains that the ListDomains API returns.

" } }, + "GetControlRequest": { + "base": null, + "refs": { + } + }, + "GetControlResponse": { + "base": null, + "refs": { + } + }, "InternalServerException": { "base": "

An internal service error occurred during the processing of your request. Try again later.

", "refs": { @@ -96,6 +146,16 @@ "refs": { } }, + "ListControlsRequest": { + "base": null, + "refs": { + } + }, + "ListControlsResponse": { + "base": null, + "refs": { + } + }, "ListDomainsRequest": { "base": null, "refs": { @@ -122,6 +182,12 @@ "ListCommonControlsRequest$MaxResults": "

The maximum number of results on a page or for an API request call.

" } }, + "MaxListControlsResults": { + "base": null, + "refs": { + "ListControlsRequest$MaxResults": "

The maximum number of results on a page or for an API request call.

" + } + }, "MaxListDomainsResults": { "base": null, "refs": { @@ -177,25 +243,49 @@ "refs": { "ListCommonControlsRequest$NextToken": "

The pagination token that's used to fetch the next set of results.

", "ListCommonControlsResponse$NextToken": "

The pagination token that's used to fetch the next set of results.

", + "ListControlsRequest$NextToken": "

The pagination token that's used to fetch the next set of results.

", + "ListControlsResponse$NextToken": "

The pagination token that's used to fetch the next set of results.

", "ListDomainsRequest$NextToken": "

The pagination token that's used to fetch the next set of results.

", "ListDomainsResponse$NextToken": "

The pagination token that's used to fetch the next set of results.

", "ListObjectivesRequest$NextToken": "

The pagination token that's used to fetch the next set of results.

", "ListObjectivesResponse$NextToken": "

The pagination token that's used to fetch the next set of results.

" } }, + "RegionCode": { + "base": null, + "refs": { + "DeployableRegions$member": null + } + }, + "RegionConfiguration": { + "base": "

Returns information about the control, including the scope of the control, if enabled, and the Regions in which the control currently is available for deployment.

If you are applying controls through an Amazon Web Services Control Tower landing zone environment, remember that the values returned in the RegionConfiguration API operation are not related to the governed Regions in your landing zone. For example, if you are governing Regions A,B,and C while the control is available in Regions A, B, C, and D, you'd see a response with DeployableRegions of A, B, C, and D for a control with REGIONAL scope, even though you may not intend to deploy the control in Region D, because you do not govern it through your landing zone.

", + "refs": { + "GetControlResponse$RegionConfiguration": null + } + }, + "ResourceNotFoundException": { + "base": "

The requested resource does not exist.

", + "refs": { + } + }, "String": { "base": null, "refs": { "AccessDeniedException$Message": null, "AssociatedDomainSummary$Name": "

The name of the related domain.

", "AssociatedObjectiveSummary$Name": "

The name of the related objective.

", - "CommonControlSummary$Description": "

The description of the common control.

", "CommonControlSummary$Name": "

The name of the common control.

", - "DomainSummary$Description": "

The description of the domain.

", + "CommonControlSummary$Description": "

The description of the common control.

", + "ControlSummary$Name": "

The display name of the control.

", + "ControlSummary$Description": "

A description of the control, as it may appear in the console. Describes the functionality of the control.

", "DomainSummary$Name": "

The name of the domain.

", + "DomainSummary$Description": "

The description of the domain.

", + "GetControlResponse$Name": "

The display name of the control.

", + "GetControlResponse$Description": "

A description of what the control does.

", "InternalServerException$Message": null, - "ObjectiveSummary$Description": "

The description of the objective.

", "ObjectiveSummary$Name": "

The name of the objective.

", + "ObjectiveSummary$Description": "

The description of the objective.

", + "ResourceNotFoundException$Message": null, "ThrottlingException$Message": null, "ValidationException$Message": null } diff --git a/apis/controlcatalog/2018-05-10/paginators-1.json b/apis/controlcatalog/2018-05-10/paginators-1.json index d716b3dcefc..2ff838410cf 100644 --- a/apis/controlcatalog/2018-05-10/paginators-1.json +++ b/apis/controlcatalog/2018-05-10/paginators-1.json @@ -6,6 +6,12 @@ "limit_key": "MaxResults", "result_key": "CommonControls" }, + "ListControls": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "Controls" + }, "ListDomains": { "input_token": "NextToken", "output_token": "NextToken", diff --git a/apis/controlcatalog/2018-05-10/waiters-2.json b/apis/controlcatalog/2018-05-10/waiters-2.json new file mode 100644 index 00000000000..13f60ee66be --- /dev/null +++ b/apis/controlcatalog/2018-05-10/waiters-2.json @@ -0,0 +1,5 @@ +{ + "version": 2, + "waiters": { + } +} diff --git a/apis/controltower/2018-05-10/docs-2.json b/apis/controltower/2018-05-10/docs-2.json index 454ae9fb95a..61dd8063abb 100644 --- a/apis/controltower/2018-05-10/docs-2.json +++ b/apis/controltower/2018-05-10/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "

Amazon Web Services Control Tower offers application programming interface (API) operations that support programmatic interaction with these types of resources:

For more information about these types of resources, see the Amazon Web Services Control Tower User Guide .

About control APIs

These interfaces allow you to apply the Amazon Web Services library of pre-defined controls to your organizational units, programmatically. In Amazon Web Services Control Tower, the terms \"control\" and \"guardrail\" are synonyms.

To call these APIs, you'll need to know:

To get the controlIdentifier for your Amazon Web Services Control Tower control:

The controlIdentifier is an ARN that is specified for each control. You can view the controlIdentifier in the console on the Control details page, as well as in the documentation.

The controlIdentifier is unique in each Amazon Web Services Region for each control. You can find the controlIdentifier for each Region and control in the Tables of control metadata or the Control availability by Region tables in the Amazon Web Services Control Tower Controls Reference Guide.

A quick-reference list of control identifers for the Amazon Web Services Control Tower legacy Strongly recommended and Elective controls is given in Resource identifiers for APIs and controls in the Amazon Web Services Control Tower Controls Reference Guide . Remember that Mandatory controls cannot be added or removed.

ARN format: arn:aws:controltower:{REGION}::control/{CONTROL_NAME}

Example:

arn:aws:controltower:us-west-2::control/AWS-GR_AUTOSCALING_LAUNCH_CONFIG_PUBLIC_IP_DISABLED

To get the targetIdentifier:

The targetIdentifier is the ARN for an OU.

In the Amazon Web Services Organizations console, you can find the ARN for the OU on the Organizational unit details page associated with that OU.

OU ARN format:

arn:${Partition}:organizations::${MasterAccountId}:ou/o-${OrganizationId}/ou-${OrganizationalUnitId}

About landing zone APIs

You can configure and launch an Amazon Web Services Control Tower landing zone with APIs. For an introduction and steps, see Getting started with Amazon Web Services Control Tower using APIs.

For an overview of landing zone API operations, see Amazon Web Services Control Tower supports landing zone APIs. The individual API operations for landing zones are detailed in this document, the API reference manual, in the \"Actions\" section.

About baseline APIs

You can apply the AWSControlTowerBaseline baseline to an organizational unit (OU) as a way to register the OU with Amazon Web Services Control Tower, programmatically. For a general overview of this capability, see Amazon Web Services Control Tower supports APIs for OU registration and configuration with baselines.

You can call the baseline API operations to view the baselines that Amazon Web Services Control Tower enables for your landing zone, on your behalf, when setting up the landing zone. These baselines are read-only baselines.

The individual API operations for baselines are detailed in this document, the API reference manual, in the \"Actions\" section. For usage examples, see Baseline API input and output examples with CLI.

Details and examples

To view the open source resource repository on GitHub, see aws-cloudformation/aws-cloudformation-resource-providers-controltower

Recording API Requests

Amazon Web Services Control Tower supports Amazon Web Services CloudTrail, a service that records Amazon Web Services API calls for your Amazon Web Services account and delivers log files to an Amazon S3 bucket. By using information collected by CloudTrail, you can determine which requests the Amazon Web Services Control Tower service received, who made the request and when, and so on. For more about Amazon Web Services Control Tower and its support for CloudTrail, see Logging Amazon Web Services Control Tower Actions with Amazon Web Services CloudTrail in the Amazon Web Services Control Tower User Guide. To learn more about CloudTrail, including how to turn it on and find your log files, see the Amazon Web Services CloudTrail User Guide.

", + "service": "

Amazon Web Services Control Tower offers application programming interface (API) operations that support programmatic interaction with these types of resources:

For more information about these types of resources, see the Amazon Web Services Control Tower User Guide .

About control APIs

These interfaces allow you to apply the Amazon Web Services library of pre-defined controls to your organizational units, programmatically. In Amazon Web Services Control Tower, the terms \"control\" and \"guardrail\" are synonyms.

To call these APIs, you'll need to know:

To get the controlIdentifier for your Amazon Web Services Control Tower control:

The controlIdentifier is an ARN that is specified for each control. You can view the controlIdentifier in the console on the Control details page, as well as in the documentation.

About identifiers for Amazon Web Services Control Tower

The Amazon Web Services Control Tower controlIdentifier is unique in each Amazon Web Services Region for each control. You can find the controlIdentifier for each Region and control in the Tables of control metadata or the Control availability by Region tables in the Amazon Web Services Control Tower Controls Reference Guide.

A quick-reference list of control identifers for the Amazon Web Services Control Tower legacy Strongly recommended and Elective controls is given in Resource identifiers for APIs and controls in the Amazon Web Services Control Tower Controls Reference Guide . Remember that Mandatory controls cannot be added or removed.

Some controls have two identifiers

You can find the {CONTROL_CATALOG_OPAQUE_ID} in the Amazon Web Services Control Tower Controls Reference Guide , or in the Amazon Web Services Control Tower console, on the Control details page.

The Amazon Web Services Control Tower APIs for enabled controls, such as GetEnabledControl and ListEnabledControls always return an ARN of the same type given when the control was enabled.

To get the targetIdentifier:

The targetIdentifier is the ARN for an OU.

In the Amazon Web Services Organizations console, you can find the ARN for the OU on the Organizational unit details page associated with that OU.

OU ARN format:

arn:${Partition}:organizations::${MasterAccountId}:ou/o-${OrganizationId}/ou-${OrganizationalUnitId}

About landing zone APIs

You can configure and launch an Amazon Web Services Control Tower landing zone with APIs. For an introduction and steps, see Getting started with Amazon Web Services Control Tower using APIs.

For an overview of landing zone API operations, see Amazon Web Services Control Tower supports landing zone APIs. The individual API operations for landing zones are detailed in this document, the API reference manual, in the \"Actions\" section.

About baseline APIs

You can apply the AWSControlTowerBaseline baseline to an organizational unit (OU) as a way to register the OU with Amazon Web Services Control Tower, programmatically. For a general overview of this capability, see Amazon Web Services Control Tower supports APIs for OU registration and configuration with baselines.

You can call the baseline API operations to view the baselines that Amazon Web Services Control Tower enables for your landing zone, on your behalf, when setting up the landing zone. These baselines are read-only baselines.

The individual API operations for baselines are detailed in this document, the API reference manual, in the \"Actions\" section. For usage examples, see Baseline API input and output examples with CLI.

About Amazon Web Services Control Catalog identifiers

Details and examples

To view the open source resource repository on GitHub, see aws-cloudformation/aws-cloudformation-resource-providers-controltower

Recording API Requests

Amazon Web Services Control Tower supports Amazon Web Services CloudTrail, a service that records Amazon Web Services API calls for your Amazon Web Services account and delivers log files to an Amazon S3 bucket. By using information collected by CloudTrail, you can determine which requests the Amazon Web Services Control Tower service received, who made the request and when, and so on. For more about Amazon Web Services Control Tower and its support for CloudTrail, see Logging Amazon Web Services Control Tower Actions with Amazon Web Services CloudTrail in the Amazon Web Services Control Tower User Guide. To learn more about CloudTrail, including how to turn it on and find your log files, see the Amazon Web Services CloudTrail User Guide.

", "operations": { "CreateLandingZone": "

Creates a new landing zone. This API call starts an asynchronous operation that creates and configures a landing zone, based on the parameters specified in the manifest JSON file.

", "DeleteLandingZone": "

Decommissions a landing zone. This API call starts an asynchronous operation that deletes Amazon Web Services Control Tower resources deployed in accounts managed by Amazon Web Services Control Tower.

", diff --git a/apis/iam/2010-05-08/smoke-2.json b/apis/iam/2010-05-08/smoke-2.json new file mode 100644 index 00000000000..cefa15ce799 --- /dev/null +++ b/apis/iam/2010-05-08/smoke-2.json @@ -0,0 +1,29 @@ +{ + "version": 2, + "testCases": [ + { + "id": "ListUsersSuccess", + "operationName": "ListUsers", + "input": {}, + "expectation": { + "success": {} + }, + "config": { + "region": "us-east-1" + } + }, + { + "id": "GetUserFailure", + "operationName": "GetUser", + "input": { + "UserName": "fake_user" + }, + "expectation": { + "failure": {} + }, + "config": { + "region": "us-east-1" + } + } + ] +} diff --git a/apis/memorydb/2021-01-01/docs-2.json b/apis/memorydb/2021-01-01/docs-2.json index f009f0e616a..3137a5b21fe 100644 --- a/apis/memorydb/2021-01-01/docs-2.json +++ b/apis/memorydb/2021-01-01/docs-2.json @@ -11,7 +11,7 @@ "CreateSubnetGroup": "

Creates a subnet group. A subnet group is a collection of subnets (typically private) that you can designate for your clusters running in an Amazon Virtual Private Cloud (VPC) environment. When you create a cluster in an Amazon VPC, you must specify a subnet group. MemoryDB uses that subnet group to choose a subnet and IP addresses within that subnet to associate with your nodes. For more information, see Subnets and subnet groups.

", "CreateUser": "

Creates a MemoryDB user. For more information, see Authenticating users with Access Contol Lists (ACLs).

", "DeleteACL": "

Deletes an Access Control List. The ACL must first be disassociated from the cluster before it can be deleted. For more information, see Authenticating users with Access Contol Lists (ACLs).

", - "DeleteCluster": "

Deletes a cluster. It also deletes all associated nodes and node endpoints

", + "DeleteCluster": "

Deletes a cluster. It also deletes all associated nodes and node endpoints

CreateSnapshot permission is required to create a final snapshot. Without this permission, the API call will fail with an Access Denied exception.

", "DeleteParameterGroup": "

Deletes the specified parameter group. You cannot delete a parameter group if it is associated with any clusters. You cannot delete the default parameter groups in your account.

", "DeleteSnapshot": "

Deletes an existing snapshot. When you receive a successful response from this operation, MemoryDB immediately begins deleting the snapshot; you cannot cancel or revert this operation.

", "DeleteSubnetGroup": "

Deletes a subnet group. You cannot delete a default subnet group or one that is associated with any clusters.

", diff --git a/apis/rds/2014-10-31/api-2.json b/apis/rds/2014-10-31/api-2.json index bfe72605066..e70f2ff8962 100644 --- a/apis/rds/2014-10-31/api-2.json +++ b/apis/rds/2014-10-31/api-2.json @@ -3876,6 +3876,7 @@ "DBClusterIdentifier":{"shape":"String"}, "ComputeRedundancy":{"shape":"IntegerOptional"}, "MaxACU":{"shape":"DoubleOptional"}, + "MinACU":{"shape":"DoubleOptional"}, "PubliclyAccessible":{"shape":"BooleanOptional"} } }, @@ -5426,6 +5427,7 @@ "DBShardGroupIdentifier":{"shape":"DBShardGroupIdentifier"}, "DBClusterIdentifier":{"shape":"String"}, "MaxACU":{"shape":"DoubleOptional"}, + "MinACU":{"shape":"DoubleOptional"}, "ComputeRedundancy":{"shape":"IntegerOptional"}, "Status":{"shape":"String"}, "PubliclyAccessible":{"shape":"BooleanOptional"}, @@ -8061,7 +8063,8 @@ "required":["DBShardGroupIdentifier"], "members":{ "DBShardGroupIdentifier":{"shape":"DBShardGroupIdentifier"}, - "MaxACU":{"shape":"DoubleOptional"} + "MaxACU":{"shape":"DoubleOptional"}, + "MinACU":{"shape":"DoubleOptional"} } }, "ModifyDBSnapshotAttributeMessage":{ diff --git a/apis/rds/2014-10-31/docs-2.json b/apis/rds/2014-10-31/docs-2.json index bba68e15096..83e06e6deff 100644 --- a/apis/rds/2014-10-31/docs-2.json +++ b/apis/rds/2014-10-31/docs-2.json @@ -490,7 +490,7 @@ "DBSnapshot$Encrypted": "

Indicates whether the DB snapshot is encrypted.

", "DBSnapshot$IAMDatabaseAuthenticationEnabled": "

Indicates whether mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts is enabled.

", "DBSnapshot$DedicatedLogVolume": "

Indicates whether the DB instance has a dedicated log volume (DLV) enabled.

", - "DeleteDBClusterMessage$SkipFinalSnapshot": "

Specifies whether to skip the creation of a final DB cluster snapshot before the DB cluster is deleted. If skip is specified, no DB cluster snapshot is created. If skip isn't specified, a DB cluster snapshot is created before the DB cluster is deleted. By default, skip isn't specified, and the DB cluster snapshot is created. By default, this parameter is disabled.

You must specify a FinalDBSnapshotIdentifier parameter if SkipFinalSnapshot is disabled.

", + "DeleteDBClusterMessage$SkipFinalSnapshot": "

Specifies whether to skip the creation of a final DB cluster snapshot before RDS deletes the DB cluster. If you set this value to true, RDS doesn't create a final DB cluster snapshot. If you set this value to false or don't specify it, RDS creates a DB cluster snapshot before it deletes the DB cluster. By default, this parameter is disabled, so RDS creates a final DB cluster snapshot.

If SkipFinalSnapshot is disabled, you must specify a value for the FinalDBSnapshotIdentifier parameter.

", "DeleteDBInstanceMessage$SkipFinalSnapshot": "

Specifies whether to skip the creation of a final DB snapshot before deleting the instance. If you enable this parameter, RDS doesn't create a DB snapshot. If you don't enable this parameter, RDS creates a DB snapshot before the DB instance is deleted. By default, skip isn't enabled, and the DB snapshot is created.

If you don't enable this parameter, you must specify the FinalDBSnapshotIdentifier parameter.

When a DB instance is in a failure state and has a status of failed, incompatible-restore, or incompatible-network, RDS can delete the instance only if you enable this parameter.

If you delete a read replica or an RDS Custom instance, you must enable this setting.

This setting is required for RDS Custom.

", "DeleteTenantDatabaseMessage$SkipFinalSnapshot": "

Specifies whether to skip the creation of a final DB snapshot before removing the tenant database from your DB instance. If you enable this parameter, RDS doesn't create a DB snapshot. If you don't enable this parameter, RDS creates a DB snapshot before it deletes the tenant database. By default, RDS doesn't skip the final snapshot. If you don't enable this parameter, you must specify the FinalDBSnapshotIdentifier parameter.

", "DescribeDBClusterSnapshotsMessage$IncludeShared": "

Specifies whether to include shared manual DB cluster snapshots from other Amazon Web Services accounts that this Amazon Web Services account has been given permission to copy or restore. By default, these snapshots are not included.

You can give an Amazon Web Services account permission to restore a manual DB cluster snapshot from another Amazon Web Services account by the ModifyDBClusterSnapshotAttribute API action.

", @@ -625,7 +625,7 @@ "DBShardGroup$PubliclyAccessible": "

Indicates whether the DB shard group is publicly accessible.

When the DB shard group is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB shard group's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB shard group's VPC. Access to the DB shard group is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB shard group doesn't permit it.

When the DB shard group isn't publicly accessible, it is an internal DB shard group with a DNS name that resolves to a private IP address.

For more information, see CreateDBShardGroup.

This setting is only for Aurora Limitless Database.

", "DBSnapshot$MultiTenant": "

Indicates whether the snapshot is of a DB instance using the multi-tenant configuration (TRUE) or the single-tenant configuration (FALSE).

", "DeleteBlueGreenDeploymentRequest$DeleteTarget": "

Specifies whether to delete the resources in the green environment. You can't specify this option if the blue/green deployment status is SWITCHOVER_COMPLETED.

", - "DeleteDBClusterMessage$DeleteAutomatedBackups": "

Specifies whether to remove automated backups immediately after the DB cluster is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted.

You must delete automated backups for Amazon RDS Multi-AZ DB clusters. For more information about managing automated backups for RDS Multi-AZ DB clusters, see Managing automated backups.

", + "DeleteDBClusterMessage$DeleteAutomatedBackups": "

Specifies whether to remove automated backups immediately after the DB cluster is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted.

", "DeleteDBInstanceMessage$DeleteAutomatedBackups": "

Specifies whether to remove automated backups immediately after the DB instance is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB instance is deleted.

", "DescribeDBEngineVersionsMessage$ListSupportedCharacterSets": "

Specifies whether to list the supported character sets for each engine version.

If this parameter is enabled and the requested engine supports the CharacterSetName parameter for CreateDBInstance, the response includes a list of supported character sets for each engine version.

For RDS Custom, the default is not to list supported character sets. If you enable this parameter, RDS Custom returns no results.

", "DescribeDBEngineVersionsMessage$ListSupportedTimezones": "

Specifies whether to list the supported time zones for each engine version.

If this parameter is enabled and the requested engine supports the TimeZone parameter for CreateDBInstance, the response includes a list of supported time zones for each engine version.

For RDS Custom, the default is not to list supported time zones. If you enable this parameter, RDS Custom returns no results.

", @@ -1790,7 +1790,7 @@ "refs": { "CreateDBInstanceMessage$DBSecurityGroups": "

A list of DB security groups to associate with this DB instance.

This setting applies to the legacy EC2-Classic platform, which is no longer used to create new DB instances. Use the VpcSecurityGroupIds setting instead.

", "ModifyDBInstanceMessage$DBSecurityGroups": "

A list of DB security groups to authorize on this DB instance. Changing this setting doesn't result in an outage and the change is asynchronously applied as soon as possible.

This setting doesn't apply to RDS Custom DB instances.

Constraints:

", - "OptionConfiguration$DBSecurityGroupMemberships": "

A list of DBSecurityGroupMembership name strings used for this option.

", + "OptionConfiguration$DBSecurityGroupMemberships": "

A list of DB security groups used for this option.

", "RestoreDBInstanceFromS3Message$DBSecurityGroups": "

A list of DB security groups to associate with this DB instance.

Default: The default DB security group for the database engine.

" } }, @@ -2533,9 +2533,12 @@ "base": null, "refs": { "CreateDBShardGroupMessage$MaxACU": "

The maximum capacity of the DB shard group in Aurora capacity units (ACUs).

", + "CreateDBShardGroupMessage$MinACU": "

The minimum capacity of the DB shard group in Aurora capacity units (ACUs).

", "DBShardGroup$MaxACU": "

The maximum capacity of the DB shard group in Aurora capacity units (ACUs).

", + "DBShardGroup$MinACU": "

The minimum capacity of the DB shard group in Aurora capacity units (ACUs).

", "LimitlessDatabase$MinRequiredACU": "

The minimum required capacity for Aurora Limitless Database in Aurora capacity units (ACUs).

", "ModifyDBShardGroupMessage$MaxACU": "

The maximum capacity of the DB shard group in Aurora capacity units (ACUs).

", + "ModifyDBShardGroupMessage$MinACU": "

The minimum capacity of the DB shard group in Aurora capacity units (ACUs).

", "OrderableDBInstanceOption$MinIopsPerGib": "

Minimum provisioned IOPS per GiB for a DB instance.

", "OrderableDBInstanceOption$MaxIopsPerGib": "

Maximum provisioned IOPS per GiB for a DB instance.

", "OrderableDBInstanceOption$MinStorageThroughputPerIops": "

Minimum storage throughput to provisioned IOPS ratio for a DB instance.

", @@ -3751,7 +3754,7 @@ } }, "OptionConfiguration": { - "base": "

A list of all available options

", + "base": "

A list of all available options for an option group.

", "refs": { "OptionConfigurationList$member": null } @@ -5079,7 +5082,7 @@ "DeleteDBClusterAutomatedBackupMessage$DbClusterResourceId": "

The identifier for the source DB cluster, which can't be changed and which is unique to an Amazon Web Services Region.

", "DeleteDBClusterEndpointMessage$DBClusterEndpointIdentifier": "

The identifier associated with the custom endpoint. This parameter is stored as a lowercase string.

", "DeleteDBClusterMessage$DBClusterIdentifier": "

The DB cluster identifier for the DB cluster to be deleted. This parameter isn't case-sensitive.

Constraints:

", - "DeleteDBClusterMessage$FinalDBSnapshotIdentifier": "

The DB cluster snapshot identifier of the new DB cluster snapshot created when SkipFinalSnapshot is disabled.

Specifying this parameter and also skipping the creation of a final DB cluster snapshot with the SkipFinalShapshot parameter results in an error.

Constraints:

", + "DeleteDBClusterMessage$FinalDBSnapshotIdentifier": "

The DB cluster snapshot identifier of the new DB cluster snapshot created when SkipFinalSnapshot is disabled.

If you specify this parameter and also skip the creation of a final DB cluster snapshot with the SkipFinalShapshot parameter, the request results in an error.

Constraints:

", "DeleteDBClusterParameterGroupMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group.

Constraints:

", "DeleteDBClusterSnapshotMessage$DBClusterSnapshotIdentifier": "

The identifier of the DB cluster snapshot to delete.

Constraints: Must be the name of an existing DB cluster snapshot in the available state.

", "DeleteDBInstanceAutomatedBackupMessage$DbiResourceId": "

The identifier for the source DB instance, which can't be changed and which is unique to an Amazon Web Services Region.

", @@ -5115,7 +5118,7 @@ "DescribeDBClusterParameterGroupsMessage$DBClusterParameterGroupName": "

The name of a specific DB cluster parameter group to return details for.

Constraints:

", "DescribeDBClusterParameterGroupsMessage$Marker": "

An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", "DescribeDBClusterParametersMessage$DBClusterParameterGroupName": "

The name of a specific DB cluster parameter group to return parameter details for.

Constraints:

", - "DescribeDBClusterParametersMessage$Source": "

A specific source to return parameters for.

Valid Values:

", + "DescribeDBClusterParametersMessage$Source": "

A specific source to return parameters for.

Valid Values:

", "DescribeDBClusterParametersMessage$Marker": "

An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", "DescribeDBClusterSnapshotAttributesMessage$DBClusterSnapshotIdentifier": "

The identifier for the DB cluster snapshot to describe the attributes for.

", "DescribeDBClusterSnapshotsMessage$DBClusterIdentifier": "

The ID of the DB cluster to retrieve the list of DB cluster snapshots for. This parameter can't be used in conjunction with the DBClusterSnapshotIdentifier parameter. This parameter isn't case-sensitive.

Constraints:

", @@ -5939,13 +5942,13 @@ } }, "Tag": { - "base": "

Metadata assigned to an Amazon RDS resource consisting of a key-value pair.

For more information, see Tagging Amazon RDS Resources in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS Resources in the Amazon Aurora User Guide.

", + "base": "

Metadata assigned to an Amazon RDS resource consisting of a key-value pair.

For more information, see Tagging Amazon RDS resources in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS resources in the Amazon Aurora User Guide.

", "refs": { "TagList$member": null } }, "TagList": { - "base": "

A list of tags. For more information, see Tagging Amazon RDS Resources in the Amazon RDS User Guide.

", + "base": "

A list of tags.

For more information, see Tagging Amazon RDS resources in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS resources in the Amazon Aurora User Guide.

", "refs": { "AddTagsToResourceMessage$Tags": "

The tags to be assigned to the Amazon RDS resource.

", "BlueGreenDeployment$TagList": null, @@ -6177,7 +6180,7 @@ "CreateDBInstanceReadReplicaMessage$VpcSecurityGroupIds": "

A list of Amazon EC2 VPC security groups to associate with the read replica.

This setting doesn't apply to RDS Custom DB instances.

Default: The default EC2 VPC security group for the DB subnet group's VPC.

", "ModifyDBClusterMessage$VpcSecurityGroupIds": "

A list of EC2 VPC security groups to associate with this DB cluster.

Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters

", "ModifyDBInstanceMessage$VpcSecurityGroupIds": "

A list of Amazon EC2 VPC security groups to associate with this DB instance. This change is asynchronously applied as soon as possible.

This setting doesn't apply to the following DB instances:

Constraints:

", - "OptionConfiguration$VpcSecurityGroupMemberships": "

A list of VpcSecurityGroupMembership name strings used for this option.

", + "OptionConfiguration$VpcSecurityGroupMemberships": "

A list of VPC security group names used for this option.

", "RestoreDBClusterFromS3Message$VpcSecurityGroupIds": "

A list of EC2 VPC security groups to associate with the restored DB cluster.

", "RestoreDBClusterFromSnapshotMessage$VpcSecurityGroupIds": "

A list of VPC security groups that the new DB cluster will belong to.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

", "RestoreDBClusterToPointInTimeMessage$VpcSecurityGroupIds": "

A list of VPC security groups that the new DB cluster belongs to.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

", diff --git a/apis/sagemaker/2017-07-24/api-2.json b/apis/sagemaker/2017-07-24/api-2.json index 80e65f5922f..84ccab295d3 100644 --- a/apis/sagemaker/2017-07-24/api-2.json +++ b/apis/sagemaker/2017-07-24/api-2.json @@ -4528,6 +4528,11 @@ "CreatedBy":{"shape":"UserContext"} } }, + "AssumableRoleArns":{ + "type":"list", + "member":{"shape":"RoleArn"}, + "max":5 + }, "AsyncInferenceClientConfig":{ "type":"structure", "members":{ @@ -11544,6 +11549,13 @@ "max":10, "pattern":"\\d+" }, + "EmrSettings":{ + "type":"structure", + "members":{ + "AssumableRoleArns":{"shape":"AssumableRoleArns"}, + "ExecutionRoleArns":{"shape":"ExecutionRoleArns"} + } + }, "EnableCapture":{"type":"boolean"}, "EnableInfraCheck":{"type":"boolean"}, "EnableIotRoleAlias":{"type":"boolean"}, @@ -11832,6 +11844,11 @@ "type":"string", "max":100 }, + "ExecutionRoleArns":{ + "type":"list", + "member":{"shape":"RoleArn"}, + "max":5 + }, "ExecutionRoleIdentityConfig":{ "type":"string", "enum":[ @@ -14276,7 +14293,8 @@ "DefaultResourceSpec":{"shape":"ResourceSpec"}, "CustomImages":{"shape":"CustomImages"}, "LifecycleConfigArns":{"shape":"LifecycleConfigArns"}, - "CodeRepositories":{"shape":"CodeRepositories"} + "CodeRepositories":{"shape":"CodeRepositories"}, + "EmrSettings":{"shape":"EmrSettings"} } }, "JupyterServerAppSettings":{ diff --git a/apis/sagemaker/2017-07-24/docs-2.json b/apis/sagemaker/2017-07-24/docs-2.json index a5cc59e24da..c0688c266e2 100644 --- a/apis/sagemaker/2017-07-24/docs-2.json +++ b/apis/sagemaker/2017-07-24/docs-2.json @@ -897,6 +897,12 @@ "AssociationSummaries$member": null } }, + "AssumableRoleArns": { + "base": null, + "refs": { + "EmrSettings$AssumableRoleArns": "

An array of Amazon Resource Names (ARNs) of the IAM roles that the execution role of SageMaker can assume for performing operations or tasks related to Amazon EMR clusters or Amazon EMR Serverless applications. These roles define the permissions and access policies required when performing Amazon EMR-related operations, such as listing, connecting to, or terminating Amazon EMR clusters or Amazon EMR Serverless applications. They are typically used in cross-account access scenarios, where the Amazon EMR resources (clusters or serverless applications) are located in a different Amazon Web Services account than the SageMaker domain.

" + } + }, "AsyncInferenceClientConfig": { "base": "

Configures the behavior of the client used by SageMaker to interact with the model container during asynchronous inference.

", "refs": { @@ -5304,6 +5310,12 @@ "DescribeUserProfileResponse$HomeEfsFileSystemUid": "

The ID of the user's profile in the Amazon Elastic File System volume.

" } }, + "EmrSettings": { + "base": "

The configuration parameters that specify the IAM roles assumed by the execution role of SageMaker (assumable roles) and the cluster instances or job execution environments (execution roles or runtime roles) to manage and access resources required for running Amazon EMR clusters or Amazon EMR Serverless applications.

", + "refs": { + "JupyterLabAppSettings$EmrSettings": "

The configuration parameters that specify the IAM roles assumed by the execution role of SageMaker (assumable roles) and the cluster instances or job execution environments (execution roles or runtime roles) to manage and access resources required for running Amazon EMR clusters or Amazon EMR Serverless applications.

" + } + }, "EnableCapture": { "base": null, "refs": { @@ -5748,6 +5760,12 @@ "EndpointInput$ExcludeFeaturesAttribute": "

The attributes of the input data to exclude from the analysis.

" } }, + "ExecutionRoleArns": { + "base": null, + "refs": { + "EmrSettings$ExecutionRoleArns": "

An array of Amazon Resource Names (ARNs) of the IAM roles used by the Amazon EMR cluster instances or job execution environments to access other Amazon Web Services services and resources needed during the runtime of your Amazon EMR or Amazon EMR Serverless workloads, such as Amazon S3 for data access, Amazon CloudWatch for logging, or other Amazon Web Services services based on the particular workload requirements.

" + } + }, "ExecutionRoleIdentityConfig": { "base": null, "refs": { @@ -13443,6 +13461,7 @@ "base": null, "refs": { "AlgorithmValidationSpecification$ValidationRole": "

The IAM roles that SageMaker uses to run the training jobs.

", + "AssumableRoleArns$member": null, "ClusterInstanceGroupDetails$ExecutionRole": "

The execution role for the instance group to assume.

", "ClusterInstanceGroupSpecification$ExecutionRole": "

Specifies an IAM execution role to be assumed by the instance group.

", "CreateAutoMLJobRequest$RoleArn": "

The ARN of the role that is used to access the data.

", @@ -13492,6 +13511,7 @@ "DescribePipelineResponse$RoleArn": "

The Amazon Resource Name (ARN) that the pipeline uses to execute.

", "DescribeProcessingJobResponse$RoleArn": "

The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker can assume to perform tasks on your behalf.

", "DescribeTrainingJobResponse$RoleArn": "

The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.

", + "ExecutionRoleArns$member": null, "FeatureGroup$RoleArn": "

The Amazon Resource Name (ARN) of the IAM execution role used to create the feature group.

", "GenerativeAiSettings$AmazonBedrockRoleArn": "

The ARN of an Amazon Web Services IAM role that allows fine-tuning of large language models (LLMs) in Amazon Bedrock. The IAM role should have Amazon S3 read and write permissions, as well as a trust relationship that establishes bedrock.amazonaws.com as a service principal.

", "HyperParameterTrainingJobDefinition$RoleArn": "

The Amazon Resource Name (ARN) of the IAM role associated with the training jobs that the tuning job launches.

", diff --git a/apis/ssm-quicksetup/2018-05-10/api-2.json b/apis/ssm-quicksetup/2018-05-10/api-2.json new file mode 100644 index 00000000000..49d6ebe9bf5 --- /dev/null +++ b/apis/ssm-quicksetup/2018-05-10/api-2.json @@ -0,0 +1,777 @@ +{ + "version":"2.0", + "metadata":{ + "apiVersion":"2018-05-10", + "endpointPrefix":"ssm-quicksetup", + "jsonVersion":"1.1", + "protocol":"rest-json", + "protocols":["rest-json"], + "serviceFullName":"AWS Systems Manager QuickSetup", + "serviceId":"SSM QuickSetup", + "signatureVersion":"v4", + "signingName":"ssm-quicksetup", + "uid":"ssm-quicksetup-2018-05-10", + "auth":["aws.auth#sigv4"] + }, + "operations":{ + "CreateConfigurationManager":{ + "name":"CreateConfigurationManager", + "http":{ + "method":"POST", + "requestUri":"/configurationManager", + "responseCode":200 + }, + "input":{"shape":"CreateConfigurationManagerInput"}, + "output":{"shape":"CreateConfigurationManagerOutput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"} + ] + }, + "DeleteConfigurationManager":{ + "name":"DeleteConfigurationManager", + "http":{ + "method":"DELETE", + "requestUri":"/configurationManager/{ManagerArn}", + "responseCode":200 + }, + "input":{"shape":"DeleteConfigurationManagerInput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ResourceNotFoundException"} + ], + "idempotent":true + }, + "GetConfigurationManager":{ + "name":"GetConfigurationManager", + "http":{ + "method":"GET", + "requestUri":"/configurationManager/{ManagerArn}", + "responseCode":200 + }, + "input":{"shape":"GetConfigurationManagerInput"}, + "output":{"shape":"GetConfigurationManagerOutput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ResourceNotFoundException"} + ] + }, + "GetServiceSettings":{ + "name":"GetServiceSettings", + "http":{ + "method":"GET", + "requestUri":"/serviceSettings", + "responseCode":200 + }, + "output":{"shape":"GetServiceSettingsOutput"}, + "errors":[ + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"} + ] + }, + "ListConfigurationManagers":{ + "name":"ListConfigurationManagers", + "http":{ + "method":"POST", + "requestUri":"/listConfigurationManagers", + "responseCode":200 + }, + "input":{"shape":"ListConfigurationManagersInput"}, + "output":{"shape":"ListConfigurationManagersOutput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"} + ] + }, + "ListQuickSetupTypes":{ + "name":"ListQuickSetupTypes", + "http":{ + "method":"GET", + "requestUri":"/listQuickSetupTypes", + "responseCode":200 + }, + "output":{"shape":"ListQuickSetupTypesOutput"}, + "errors":[ + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"} + ] + }, + "ListTagsForResource":{ + "name":"ListTagsForResource", + "http":{ + "method":"GET", + "requestUri":"/tags/{ResourceArn}", + "responseCode":200 + }, + "input":{"shape":"ListTagsForResourceRequest"}, + "output":{"shape":"ListTagsForResourceResponse"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ResourceNotFoundException"} + ] + }, + "TagResource":{ + "name":"TagResource", + "http":{ + "method":"PUT", + "requestUri":"/tags/{ResourceArn}", + "responseCode":200 + }, + "input":{"shape":"TagResourceInput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ResourceNotFoundException"} + ], + "idempotent":true + }, + "UntagResource":{ + "name":"UntagResource", + "http":{ + "method":"DELETE", + "requestUri":"/tags/{ResourceArn}", + "responseCode":200 + }, + "input":{"shape":"UntagResourceInput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ResourceNotFoundException"} + ], + "idempotent":true + }, + "UpdateConfigurationDefinition":{ + "name":"UpdateConfigurationDefinition", + "http":{ + "method":"PUT", + "requestUri":"/configurationDefinition/{ManagerArn}/{Id}", + "responseCode":200 + }, + "input":{"shape":"UpdateConfigurationDefinitionInput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ResourceNotFoundException"} + ], + "idempotent":true + }, + "UpdateConfigurationManager":{ + "name":"UpdateConfigurationManager", + "http":{ + "method":"PUT", + "requestUri":"/configurationManager/{ManagerArn}", + "responseCode":200 + }, + "input":{"shape":"UpdateConfigurationManagerInput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ResourceNotFoundException"} + ], + "idempotent":true + }, + "UpdateServiceSettings":{ + "name":"UpdateServiceSettings", + "http":{ + "method":"PUT", + "requestUri":"/serviceSettings", + "responseCode":200 + }, + "input":{"shape":"UpdateServiceSettingsInput"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"} + ], + "idempotent":true + } + }, + "shapes":{ + "AccessDeniedException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "error":{ + "httpStatusCode":403, + "senderFault":true + }, + "exception":true + }, + "ConfigurationDefinition":{ + "type":"structure", + "required":[ + "Parameters", + "Type" + ], + "members":{ + "Id":{"shape":"String"}, + "LocalDeploymentAdministrationRoleArn":{"shape":"IAMRoleArn"}, + "LocalDeploymentExecutionRoleName":{"shape":"ConfigurationDefinitionLocalDeploymentExecutionRoleNameString"}, + "Parameters":{"shape":"ConfigurationParametersMap"}, + "Type":{"shape":"ConfigurationDefinitionTypeString"}, + "TypeVersion":{"shape":"ConfigurationDefinitionTypeVersionString"} + } + }, + "ConfigurationDefinitionInput":{ + "type":"structure", + "required":[ + "Parameters", + "Type" + ], + "members":{ + "LocalDeploymentAdministrationRoleArn":{"shape":"IAMRoleArn"}, + "LocalDeploymentExecutionRoleName":{"shape":"ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString"}, + "Parameters":{"shape":"ConfigurationParametersMap"}, + "Type":{"shape":"ConfigurationDefinitionInputTypeString"}, + "TypeVersion":{"shape":"ConfigurationDefinitionInputTypeVersionString"} + } + }, + "ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString":{ + "type":"string", + "pattern":"^[\\w+=,.@-]{1,64}$" + }, + "ConfigurationDefinitionInputTypeString":{ + "type":"string", + "pattern":"^[a-zA-Z0-9_\\-.:/]{3,200}$" + }, + "ConfigurationDefinitionInputTypeVersionString":{ + "type":"string", + "max":128, + "min":1 + }, + "ConfigurationDefinitionLocalDeploymentExecutionRoleNameString":{ + "type":"string", + "pattern":"^[\\w+=,.@-]{1,64}$" + }, + "ConfigurationDefinitionSummariesList":{ + "type":"list", + "member":{"shape":"ConfigurationDefinitionSummary"} + }, + "ConfigurationDefinitionSummary":{ + "type":"structure", + "members":{ + "FirstClassParameters":{"shape":"ConfigurationParametersMap"}, + "Id":{"shape":"String"}, + "Type":{"shape":"String"}, + "TypeVersion":{"shape":"String"} + } + }, + "ConfigurationDefinitionTypeString":{ + "type":"string", + "pattern":"^[a-zA-Z0-9_\\-.:/]{3,200}$" + }, + "ConfigurationDefinitionTypeVersionString":{ + "type":"string", + "max":128, + "min":1 + }, + "ConfigurationDefinitionsInputList":{ + "type":"list", + "member":{"shape":"ConfigurationDefinitionInput"} + }, + "ConfigurationDefinitionsList":{ + "type":"list", + "member":{"shape":"ConfigurationDefinition"} + }, + "ConfigurationManagerList":{ + "type":"list", + "member":{"shape":"ConfigurationManagerSummary"} + }, + "ConfigurationManagerSummary":{ + "type":"structure", + "required":["ManagerArn"], + "members":{ + "ConfigurationDefinitionSummaries":{"shape":"ConfigurationDefinitionSummariesList"}, + "Description":{"shape":"String"}, + "ManagerArn":{"shape":"String"}, + "Name":{"shape":"String"}, + "StatusSummaries":{"shape":"StatusSummariesList"} + } + }, + "ConfigurationParametersMap":{ + "type":"map", + "key":{"shape":"ConfigurationParametersMapKeyString"}, + "value":{"shape":"ConfigurationParametersMapValueString"} + }, + "ConfigurationParametersMapKeyString":{ + "type":"string", + "max":256, + "min":1, + "pattern":"^[A-Za-z0-9+=@_\\/\\s-]+$" + }, + "ConfigurationParametersMapValueString":{ + "type":"string", + "max":40960, + "min":0 + }, + "ConflictException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "error":{ + "httpStatusCode":409, + "senderFault":true + }, + "exception":true + }, + "CreateConfigurationManagerInput":{ + "type":"structure", + "required":["ConfigurationDefinitions"], + "members":{ + "ConfigurationDefinitions":{"shape":"ConfigurationDefinitionsInputList"}, + "Description":{"shape":"CreateConfigurationManagerInputDescriptionString"}, + "Name":{"shape":"CreateConfigurationManagerInputNameString"}, + "Tags":{"shape":"TagsMap"} + } + }, + "CreateConfigurationManagerInputDescriptionString":{ + "type":"string", + "pattern":"^.{0,512}$" + }, + "CreateConfigurationManagerInputNameString":{ + "type":"string", + "pattern":"^[ A-Za-z0-9._-]{0,120}$" + }, + "CreateConfigurationManagerOutput":{ + "type":"structure", + "required":["ManagerArn"], + "members":{ + "ManagerArn":{"shape":"String"} + } + }, + "DeleteConfigurationManagerInput":{ + "type":"structure", + "required":["ManagerArn"], + "members":{ + "ManagerArn":{ + "shape":"DeleteConfigurationManagerInputManagerArnString", + "location":"uri", + "locationName":"ManagerArn" + } + } + }, + "DeleteConfigurationManagerInputManagerArnString":{ + "type":"string", + "pattern":"^arn:aws:ssm-quicksetup:([^:]+):(\\d{12}):configuration-manager/[0-9a-fA-F]{8}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{12}$" + }, + "Filter":{ + "type":"structure", + "required":[ + "Key", + "Values" + ], + "members":{ + "Key":{"shape":"FilterKeyString"}, + "Values":{"shape":"FilterValues"} + } + }, + "FilterKeyString":{ + "type":"string", + "max":128, + "min":0, + "pattern":"^[A-Za-z0-9+=@_\\/\\s-]*$" + }, + "FilterValues":{ + "type":"list", + "member":{"shape":"FilterValuesMemberString"} + }, + "FilterValuesMemberString":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^[A-Za-z0-9+=@_\\/\\s-]*$" + }, + "FiltersList":{ + "type":"list", + "member":{"shape":"Filter"} + }, + "GetConfigurationManagerInput":{ + "type":"structure", + "required":["ManagerArn"], + "members":{ + "ManagerArn":{ + "shape":"GetConfigurationManagerInputManagerArnString", + "location":"uri", + "locationName":"ManagerArn" + } + } + }, + "GetConfigurationManagerInputManagerArnString":{ + "type":"string", + "min":1, + "pattern":"^arn:aws:ssm-quicksetup:([^:]+):(\\d{12}):configuration-manager/[0-9a-fA-F]{8}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{12}$" + }, + "GetConfigurationManagerOutput":{ + "type":"structure", + "required":["ManagerArn"], + "members":{ + "ConfigurationDefinitions":{"shape":"ConfigurationDefinitionsList"}, + "CreatedAt":{"shape":"SyntheticTimestamp_date_time"}, + "Description":{"shape":"String"}, + "LastModifiedAt":{"shape":"SyntheticTimestamp_date_time"}, + "ManagerArn":{"shape":"String"}, + "Name":{"shape":"String"}, + "StatusSummaries":{"shape":"StatusSummariesList"}, + "Tags":{"shape":"TagsMap"} + } + }, + "GetServiceSettingsOutput":{ + "type":"structure", + "members":{ + "ServiceSettings":{"shape":"ServiceSettings"} + } + }, + "IAMRoleArn":{"type":"string"}, + "InternalServerException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "error":{"httpStatusCode":500}, + "exception":true, + "fault":true, + "retryable":{"throttling":false} + }, + "ListConfigurationManagersInput":{ + "type":"structure", + "members":{ + "Filters":{"shape":"FiltersList"}, + "MaxItems":{"shape":"ListConfigurationManagersInputMaxItemsInteger"}, + "StartingToken":{"shape":"ListConfigurationManagersInputStartingTokenString"} + } + }, + "ListConfigurationManagersInputMaxItemsInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "ListConfigurationManagersInputStartingTokenString":{ + "type":"string", + "max":1024, + "min":0, + "pattern":"^[A-Za-z0-9+=@_\\/\\s-]*$" + }, + "ListConfigurationManagersOutput":{ + "type":"structure", + "members":{ + "ConfigurationManagersList":{"shape":"ConfigurationManagerList"}, + "NextToken":{"shape":"String"} + } + }, + "ListQuickSetupTypesOutput":{ + "type":"structure", + "members":{ + "QuickSetupTypeList":{"shape":"QuickSetupTypeList"} + } + }, + "ListTagsForResourceRequest":{ + "type":"structure", + "required":["ResourceArn"], + "members":{ + "ResourceArn":{ + "shape":"String", + "location":"uri", + "locationName":"ResourceArn" + } + } + }, + "ListTagsForResourceResponse":{ + "type":"structure", + "members":{ + "Tags":{"shape":"Tags"} + } + }, + "QuickSetupTypeList":{ + "type":"list", + "member":{"shape":"QuickSetupTypeOutput"} + }, + "QuickSetupTypeOutput":{ + "type":"structure", + "members":{ + "LatestVersion":{"shape":"String"}, + "Type":{"shape":"String"} + } + }, + "ResourceNotFoundException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "error":{ + "httpStatusCode":404, + "senderFault":true + }, + "exception":true + }, + "ServiceSettings":{ + "type":"structure", + "members":{ + "ExplorerEnablingRoleArn":{"shape":"IAMRoleArn"} + } + }, + "Status":{ + "type":"string", + "enum":[ + "INITIALIZING", + "DEPLOYING", + "SUCCEEDED", + "DELETING", + "STOPPING", + "FAILED", + "STOPPED", + "DELETE_FAILED", + "STOP_FAILED", + "NONE" + ] + }, + "StatusDetails":{ + "type":"map", + "key":{"shape":"String"}, + "value":{"shape":"String"} + }, + "StatusSummariesList":{ + "type":"list", + "member":{"shape":"StatusSummary"} + }, + "StatusSummary":{ + "type":"structure", + "required":[ + "LastUpdatedAt", + "StatusType" + ], + "members":{ + "LastUpdatedAt":{"shape":"SyntheticTimestamp_date_time"}, + "Status":{"shape":"Status"}, + "StatusDetails":{"shape":"StatusDetails"}, + "StatusMessage":{"shape":"String"}, + "StatusType":{"shape":"StatusType"} + } + }, + "StatusType":{ + "type":"string", + "enum":[ + "Deployment", + "AsyncExecutions" + ] + }, + "String":{"type":"string"}, + "SyntheticTimestamp_date_time":{ + "type":"timestamp", + "timestampFormat":"iso8601" + }, + "TagEntry":{ + "type":"structure", + "members":{ + "Key":{"shape":"TagEntryKeyString"}, + "Value":{"shape":"TagEntryValueString"} + }, + "sensitive":true + }, + "TagEntryKeyString":{ + "type":"string", + "max":128, + "min":1, + "pattern":"^[A-Za-z0-9 _=@:.+-/]+$" + }, + "TagEntryValueString":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^[A-Za-z0-9 _=@:.+-/]+$" + }, + "TagKeys":{ + "type":"list", + "member":{"shape":"String"} + }, + "TagResourceInput":{ + "type":"structure", + "required":[ + "ResourceArn", + "Tags" + ], + "members":{ + "ResourceArn":{ + "shape":"String", + "location":"uri", + "locationName":"ResourceArn" + }, + "Tags":{"shape":"TagsMap"} + } + }, + "Tags":{ + "type":"list", + "member":{"shape":"TagEntry"}, + "sensitive":true + }, + "TagsMap":{ + "type":"map", + "key":{"shape":"TagsMapKeyString"}, + "value":{"shape":"TagsMapValueString"}, + "sensitive":true + }, + "TagsMapKeyString":{ + "type":"string", + "max":128, + "min":1, + "pattern":"^[A-Za-z0-9 _=@:.+-/]+$" + }, + "TagsMapValueString":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^[A-Za-z0-9 _=@:.+-/]+$" + }, + "ThrottlingException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{"shape":"String"} + }, + "error":{ + "httpStatusCode":429, + "senderFault":true + }, + "exception":true, + "retryable":{"throttling":false} + }, + "UntagResourceInput":{ + "type":"structure", + "required":[ + "ResourceArn", + "TagKeys" + ], + "members":{ + "ResourceArn":{ + "shape":"String", + "location":"uri", + "locationName":"ResourceArn" + }, + "TagKeys":{ + "shape":"TagKeys", + "location":"querystring", + "locationName":"tagKeys" + } + } + }, + "UpdateConfigurationDefinitionInput":{ + "type":"structure", + "required":[ + "Id", + "ManagerArn" + ], + "members":{ + "Id":{ + "shape":"UpdateConfigurationDefinitionInputIdString", + "location":"uri", + "locationName":"Id" + }, + "LocalDeploymentAdministrationRoleArn":{"shape":"IAMRoleArn"}, + "LocalDeploymentExecutionRoleName":{"shape":"UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString"}, + "ManagerArn":{ + "shape":"UpdateConfigurationDefinitionInputManagerArnString", + "location":"uri", + "locationName":"ManagerArn" + }, + "Parameters":{"shape":"ConfigurationParametersMap"}, + "TypeVersion":{"shape":"UpdateConfigurationDefinitionInputTypeVersionString"} + } + }, + "UpdateConfigurationDefinitionInputIdString":{ + "type":"string", + "pattern":"^[a-z0-9-]{1,20}$" + }, + "UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString":{ + "type":"string", + "pattern":"^[\\w+=,.@-]{1,64}$" + }, + "UpdateConfigurationDefinitionInputManagerArnString":{ + "type":"string", + "pattern":"^arn:aws:ssm-quicksetup:([^:]+):(\\d{12}):configuration-manager/[0-9a-fA-F]{8}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{12}$" + }, + "UpdateConfigurationDefinitionInputTypeVersionString":{ + "type":"string", + "pattern":"^\\d{1,3}(\\.\\d{1,3})?$|^LATEST$" + }, + "UpdateConfigurationManagerInput":{ + "type":"structure", + "required":["ManagerArn"], + "members":{ + "Description":{"shape":"UpdateConfigurationManagerInputDescriptionString"}, + "ManagerArn":{ + "shape":"UpdateConfigurationManagerInputManagerArnString", + "location":"uri", + "locationName":"ManagerArn" + }, + "Name":{"shape":"UpdateConfigurationManagerInputNameString"} + } + }, + "UpdateConfigurationManagerInputDescriptionString":{ + "type":"string", + "pattern":"^.{0,512}$" + }, + "UpdateConfigurationManagerInputManagerArnString":{ + "type":"string", + "pattern":"^arn:aws:ssm-quicksetup:([^:]+):(\\d{12}):configuration-manager/[0-9a-fA-F]{8}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{12}$" + }, + "UpdateConfigurationManagerInputNameString":{ + "type":"string", + "pattern":"^[ A-Za-z0-9._-]{0,120}$" + }, + "UpdateServiceSettingsInput":{ + "type":"structure", + "members":{ + "ExplorerEnablingRoleArn":{"shape":"IAMRoleArn"} + } + }, + "ValidationException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "error":{ + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + } + } +} diff --git a/apis/ssm-quicksetup/2018-05-10/docs-2.json b/apis/ssm-quicksetup/2018-05-10/docs-2.json new file mode 100644 index 00000000000..f21a2a5ec28 --- /dev/null +++ b/apis/ssm-quicksetup/2018-05-10/docs-2.json @@ -0,0 +1,492 @@ +{ + "version": "2.0", + "service": "

Quick Setup helps you quickly configure frequently used services and features with recommended best practices. Quick Setup simplifies setting up services, including Systems Manager, by automating common or recommended tasks.

", + "operations": { + "CreateConfigurationManager": "

Creates a Quick Setup configuration manager resource. This object is a collection of desired state configurations for multiple configuration definitions and summaries describing the deployments of those definitions.

", + "DeleteConfigurationManager": "

Deletes a configuration manager.

", + "GetConfigurationManager": "

Returns a configuration manager.

", + "GetServiceSettings": "

Returns settings configured for Quick Setup in the requesting Amazon Web Services account and Amazon Web Services Region.

", + "ListConfigurationManagers": "

Returns Quick Setup configuration managers.

", + "ListQuickSetupTypes": "

Returns the available Quick Setup types.

", + "ListTagsForResource": "

Returns tags assigned to the resource.

", + "TagResource": "

Assigns key-value pairs of metadata to Amazon Web Services resources.

", + "UntagResource": "

Removes tags from the specified resource.

", + "UpdateConfigurationDefinition": "

Updates a Quick Setup configuration definition.

", + "UpdateConfigurationManager": "

Updates a Quick Setup configuration manager.

", + "UpdateServiceSettings": "

Updates settings configured for Quick Setup.

" + }, + "shapes": { + "AccessDeniedException": { + "base": "

The requester has insufficient permissions to perform the operation.

", + "refs": { + } + }, + "ConfigurationDefinition": { + "base": "

The definition of a Quick Setup configuration.

", + "refs": { + "ConfigurationDefinitionsList$member": null + } + }, + "ConfigurationDefinitionInput": { + "base": "

Defines the preferences and options for a configuration definition.

", + "refs": { + "ConfigurationDefinitionsInputList$member": null + } + }, + "ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString": { + "base": null, + "refs": { + "ConfigurationDefinitionInput$LocalDeploymentExecutionRoleName": "

The name of the IAM role used to deploy local configurations.

" + } + }, + "ConfigurationDefinitionInputTypeString": { + "base": null, + "refs": { + "ConfigurationDefinitionInput$Type": "

The type of the Quick Setup configuration.

" + } + }, + "ConfigurationDefinitionInputTypeVersionString": { + "base": null, + "refs": { + "ConfigurationDefinitionInput$TypeVersion": "

The version of the Quick Setup type to use.

" + } + }, + "ConfigurationDefinitionLocalDeploymentExecutionRoleNameString": { + "base": null, + "refs": { + "ConfigurationDefinition$LocalDeploymentExecutionRoleName": "

The name of the IAM role used to deploy local configurations.

" + } + }, + "ConfigurationDefinitionSummariesList": { + "base": null, + "refs": { + "ConfigurationManagerSummary$ConfigurationDefinitionSummaries": "

A summary of the Quick Setup configuration definition.

" + } + }, + "ConfigurationDefinitionSummary": { + "base": "

A summarized definition of a Quick Setup configuration definition.

", + "refs": { + "ConfigurationDefinitionSummariesList$member": null + } + }, + "ConfigurationDefinitionTypeString": { + "base": null, + "refs": { + "ConfigurationDefinition$Type": "

The type of the Quick Setup configuration.

" + } + }, + "ConfigurationDefinitionTypeVersionString": { + "base": null, + "refs": { + "ConfigurationDefinition$TypeVersion": "

The version of the Quick Setup type used.

" + } + }, + "ConfigurationDefinitionsInputList": { + "base": null, + "refs": { + "CreateConfigurationManagerInput$ConfigurationDefinitions": "

The definition of the Quick Setup configuration that the configuration manager deploys.

" + } + }, + "ConfigurationDefinitionsList": { + "base": null, + "refs": { + "GetConfigurationManagerOutput$ConfigurationDefinitions": "

The configuration definitions association with the configuration manager.

" + } + }, + "ConfigurationManagerList": { + "base": null, + "refs": { + "ListConfigurationManagersOutput$ConfigurationManagersList": "

The configuration managers returned by the request.

" + } + }, + "ConfigurationManagerSummary": { + "base": "

A summary of a Quick Setup configuration manager.

", + "refs": { + "ConfigurationManagerList$member": null + } + }, + "ConfigurationParametersMap": { + "base": null, + "refs": { + "ConfigurationDefinition$Parameters": "

A list of key-value pairs containing the required parameters for the configuration type.

", + "ConfigurationDefinitionInput$Parameters": "

The parameters for the configuration definition type. Parameters for configuration definitions vary based the configuration type. The following tables outline the parameters for each configuration type.

OpsCenter (Type: Amazon Web ServicesQuickSetupType-SSMOpsCenter)
Resource Scheduler (Type: Amazon Web ServicesQuickSetupType-Scheduler)
Default Host Management Configuration (Type: Amazon Web ServicesQuickSetupType-DHMC)
Resource Explorer (Type: Amazon Web ServicesQuickSetupType-ResourceExplorer)
Change Manager (Type: Amazon Web ServicesQuickSetupType-SSMChangeMgr)
DevOps Guru (Type: Amazon Web ServicesQuickSetupType-DevOpsGuru)
Conformance Packs (Type: Amazon Web ServicesQuickSetupType-CFGCPacks)
Config Recording (Type: Amazon Web ServicesQuickSetupType-CFGRecording)
Host Management (Type: Amazon Web ServicesQuickSetupType-SSMHostMgmt)
Distributor (Type: Amazon Web ServicesQuickSetupType-Distributor)
Patch Policy (Type: Amazon Web ServicesQuickSetupType-PatchPolicy)
", + "ConfigurationDefinitionSummary$FirstClassParameters": "

The common parameters and values for the configuration definition.

", + "UpdateConfigurationDefinitionInput$Parameters": "

The parameters for the configuration definition type.

" + } + }, + "ConfigurationParametersMapKeyString": { + "base": null, + "refs": { + "ConfigurationParametersMap$key": null + } + }, + "ConfigurationParametersMapValueString": { + "base": null, + "refs": { + "ConfigurationParametersMap$value": null + } + }, + "ConflictException": { + "base": "

Another request is being processed. Wait a few minutes and try again.

", + "refs": { + } + }, + "CreateConfigurationManagerInput": { + "base": null, + "refs": { + } + }, + "CreateConfigurationManagerInputDescriptionString": { + "base": null, + "refs": { + "CreateConfigurationManagerInput$Description": "

A description of the configuration manager.

" + } + }, + "CreateConfigurationManagerInputNameString": { + "base": null, + "refs": { + "CreateConfigurationManagerInput$Name": "

A name for the configuration manager.

" + } + }, + "CreateConfigurationManagerOutput": { + "base": null, + "refs": { + } + }, + "DeleteConfigurationManagerInput": { + "base": null, + "refs": { + } + }, + "DeleteConfigurationManagerInputManagerArnString": { + "base": null, + "refs": { + "DeleteConfigurationManagerInput$ManagerArn": "

The ID of the configuration manager.

" + } + }, + "Filter": { + "base": "

A key-value pair to filter results.

", + "refs": { + "FiltersList$member": null + } + }, + "FilterKeyString": { + "base": null, + "refs": { + "Filter$Key": "

The key for the filter.

" + } + }, + "FilterValues": { + "base": null, + "refs": { + "Filter$Values": "

The values for the filter keys.

" + } + }, + "FilterValuesMemberString": { + "base": null, + "refs": { + "FilterValues$member": null + } + }, + "FiltersList": { + "base": null, + "refs": { + "ListConfigurationManagersInput$Filters": "

Filters the results returned by the request.

" + } + }, + "GetConfigurationManagerInput": { + "base": null, + "refs": { + } + }, + "GetConfigurationManagerInputManagerArnString": { + "base": null, + "refs": { + "GetConfigurationManagerInput$ManagerArn": "

The ARN of the configuration manager.

" + } + }, + "GetConfigurationManagerOutput": { + "base": null, + "refs": { + } + }, + "GetServiceSettingsOutput": { + "base": null, + "refs": { + } + }, + "IAMRoleArn": { + "base": null, + "refs": { + "ConfigurationDefinition$LocalDeploymentAdministrationRoleArn": "

The ARN of the IAM role used to administrate local configuration deployments.

", + "ConfigurationDefinitionInput$LocalDeploymentAdministrationRoleArn": "

The ARN of the IAM role used to administrate local configuration deployments.

", + "ServiceSettings$ExplorerEnablingRoleArn": "

The IAM role used to enable Explorer.

", + "UpdateConfigurationDefinitionInput$LocalDeploymentAdministrationRoleArn": "

The ARN of the IAM role used to administrate local configuration deployments.

", + "UpdateServiceSettingsInput$ExplorerEnablingRoleArn": "

The IAM role used to enable Explorer.

" + } + }, + "InternalServerException": { + "base": "

An error occurred on the server side.

", + "refs": { + } + }, + "ListConfigurationManagersInput": { + "base": null, + "refs": { + } + }, + "ListConfigurationManagersInputMaxItemsInteger": { + "base": null, + "refs": { + "ListConfigurationManagersInput$MaxItems": "

Specifies the maximum number of configuration managers that are returned by the request.

" + } + }, + "ListConfigurationManagersInputStartingTokenString": { + "base": null, + "refs": { + "ListConfigurationManagersInput$StartingToken": "

The token to use when requesting a specific set of items from a list.

" + } + }, + "ListConfigurationManagersOutput": { + "base": null, + "refs": { + } + }, + "ListQuickSetupTypesOutput": { + "base": null, + "refs": { + } + }, + "ListTagsForResourceRequest": { + "base": null, + "refs": { + } + }, + "ListTagsForResourceResponse": { + "base": null, + "refs": { + } + }, + "QuickSetupTypeList": { + "base": null, + "refs": { + "ListQuickSetupTypesOutput$QuickSetupTypeList": "

An array of Quick Setup types.

" + } + }, + "QuickSetupTypeOutput": { + "base": "

Information about the Quick Setup type.

", + "refs": { + "QuickSetupTypeList$member": null + } + }, + "ResourceNotFoundException": { + "base": "

The resource couldn't be found. Check the ID or name and try again.

", + "refs": { + } + }, + "ServiceSettings": { + "base": "

Settings configured for Quick Setup.

", + "refs": { + "GetServiceSettingsOutput$ServiceSettings": "

Returns details about the settings for Quick Setup in the requesting Amazon Web Services account and Amazon Web Services Region.

" + } + }, + "Status": { + "base": null, + "refs": { + "StatusSummary$Status": "

The current status.

" + } + }, + "StatusDetails": { + "base": null, + "refs": { + "StatusSummary$StatusDetails": "

Details about the status.

" + } + }, + "StatusSummariesList": { + "base": null, + "refs": { + "ConfigurationManagerSummary$StatusSummaries": "

Summaries of the state of the configuration manager. These summaries include an aggregate of the statuses from the configuration definition associated with the configuration manager. This includes deployment statuses, association statuses, drift statuses, health checks, and more.

", + "GetConfigurationManagerOutput$StatusSummaries": "

A summary of the state of the configuration manager. This includes deployment statuses, association statuses, drift statuses, health checks, and more.

" + } + }, + "StatusSummary": { + "base": "

A summarized description of the status.

", + "refs": { + "StatusSummariesList$member": null + } + }, + "StatusType": { + "base": null, + "refs": { + "StatusSummary$StatusType": "

The type of a status summary.

" + } + }, + "String": { + "base": null, + "refs": { + "AccessDeniedException$Message": null, + "ConfigurationDefinition$Id": "

The ID of the configuration definition.

", + "ConfigurationDefinitionSummary$Id": "

The ID of the configuration definition.

", + "ConfigurationDefinitionSummary$Type": "

The type of the Quick Setup configuration used by the configuration definition.

", + "ConfigurationDefinitionSummary$TypeVersion": "

The version of the Quick Setup type used by the configuration definition.

", + "ConfigurationManagerSummary$Description": "

The description of the configuration.

", + "ConfigurationManagerSummary$ManagerArn": "

The ARN of the Quick Setup configuration.

", + "ConfigurationManagerSummary$Name": "

The name of the configuration

", + "ConflictException$Message": null, + "CreateConfigurationManagerOutput$ManagerArn": "

The ARN for the newly created configuration manager.

", + "GetConfigurationManagerOutput$Description": "

The description of the configuration manager.

", + "GetConfigurationManagerOutput$ManagerArn": "

The ARN of the configuration manager.

", + "GetConfigurationManagerOutput$Name": "

The name of the configuration manager.

", + "InternalServerException$Message": null, + "ListConfigurationManagersOutput$NextToken": "

The token to use when requesting the next set of configuration managers. If there are no additional operations to return, the string is empty.

", + "ListTagsForResourceRequest$ResourceArn": "

The ARN of the resource the tag is assigned to.

", + "QuickSetupTypeOutput$LatestVersion": "

The latest version number of the configuration.

", + "QuickSetupTypeOutput$Type": "

The type of the Quick Setup configuration.

", + "ResourceNotFoundException$Message": null, + "StatusDetails$key": null, + "StatusDetails$value": null, + "StatusSummary$StatusMessage": "

When applicable, returns an informational message relevant to the current status and status type of the status summary object. We don't recommend implementing parsing logic around this value since the messages returned can vary in format.

", + "TagKeys$member": null, + "TagResourceInput$ResourceArn": "

The ARN of the resource to tag.

", + "ThrottlingException$Message": null, + "UntagResourceInput$ResourceArn": "

The ARN of the resource to remove tags from.

", + "ValidationException$Message": null + } + }, + "SyntheticTimestamp_date_time": { + "base": null, + "refs": { + "GetConfigurationManagerOutput$CreatedAt": "

The datetime stamp when the configuration manager was created.

", + "GetConfigurationManagerOutput$LastModifiedAt": "

The datetime stamp when the configuration manager was last updated.

", + "StatusSummary$LastUpdatedAt": "

The datetime stamp when the status was last updated.

" + } + }, + "TagEntry": { + "base": "

Key-value pairs of metadata.

", + "refs": { + "Tags$member": null + } + }, + "TagEntryKeyString": { + "base": null, + "refs": { + "TagEntry$Key": "

The key for the tag.

" + } + }, + "TagEntryValueString": { + "base": null, + "refs": { + "TagEntry$Value": "

The value for the tag.

" + } + }, + "TagKeys": { + "base": null, + "refs": { + "UntagResourceInput$TagKeys": "

The keys of the tags to remove from the resource.

" + } + }, + "TagResourceInput": { + "base": null, + "refs": { + } + }, + "Tags": { + "base": null, + "refs": { + "ListTagsForResourceResponse$Tags": "

Key-value pairs of metadata assigned to the resource.

" + } + }, + "TagsMap": { + "base": null, + "refs": { + "CreateConfigurationManagerInput$Tags": "

Key-value pairs of metadata to assign to the configuration manager.

", + "GetConfigurationManagerOutput$Tags": "

Key-value pairs of metadata to assign to the configuration manager.

", + "TagResourceInput$Tags": "

Key-value pairs of metadata to assign to the resource.

" + } + }, + "TagsMapKeyString": { + "base": null, + "refs": { + "TagsMap$key": null + } + }, + "TagsMapValueString": { + "base": null, + "refs": { + "TagsMap$value": null + } + }, + "ThrottlingException": { + "base": "

The request or operation exceeds the maximum allowed request rate per Amazon Web Services account and Amazon Web Services Region.

", + "refs": { + } + }, + "UntagResourceInput": { + "base": null, + "refs": { + } + }, + "UpdateConfigurationDefinitionInput": { + "base": null, + "refs": { + } + }, + "UpdateConfigurationDefinitionInputIdString": { + "base": null, + "refs": { + "UpdateConfigurationDefinitionInput$Id": "

The ID of the configuration definition you want to update.

" + } + }, + "UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString": { + "base": null, + "refs": { + "UpdateConfigurationDefinitionInput$LocalDeploymentExecutionRoleName": "

The name of the IAM role used to deploy local configurations.

" + } + }, + "UpdateConfigurationDefinitionInputManagerArnString": { + "base": null, + "refs": { + "UpdateConfigurationDefinitionInput$ManagerArn": "

The ARN of the configuration manager associated with the definition to update.

" + } + }, + "UpdateConfigurationDefinitionInputTypeVersionString": { + "base": null, + "refs": { + "UpdateConfigurationDefinitionInput$TypeVersion": "

The version of the Quick Setup type to use.

" + } + }, + "UpdateConfigurationManagerInput": { + "base": null, + "refs": { + } + }, + "UpdateConfigurationManagerInputDescriptionString": { + "base": null, + "refs": { + "UpdateConfigurationManagerInput$Description": "

A description of the configuration manager.

" + } + }, + "UpdateConfigurationManagerInputManagerArnString": { + "base": null, + "refs": { + "UpdateConfigurationManagerInput$ManagerArn": "

The ARN of the configuration manager.

" + } + }, + "UpdateConfigurationManagerInputNameString": { + "base": null, + "refs": { + "UpdateConfigurationManagerInput$Name": "

A name for the configuration manager.

" + } + }, + "UpdateServiceSettingsInput": { + "base": null, + "refs": { + } + }, + "ValidationException": { + "base": "

The request is invalid. Verify the values provided for the request parameters are accurate.

", + "refs": { + } + } + } +} diff --git a/apis/ssm-quicksetup/2018-05-10/endpoint-rule-set-1.json b/apis/ssm-quicksetup/2018-05-10/endpoint-rule-set-1.json new file mode 100644 index 00000000000..31c96c7c39a --- /dev/null +++ b/apis/ssm-quicksetup/2018-05-10/endpoint-rule-set-1.json @@ -0,0 +1,350 @@ +{ + "version": "1.0", + "parameters": { + "Region": { + "builtIn": "AWS::Region", + "required": false, + "documentation": "The AWS region used to dispatch the request.", + "type": "String" + }, + "UseDualStack": { + "builtIn": "AWS::UseDualStack", + "required": true, + "default": false, + "documentation": "When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.", + "type": "Boolean" + }, + "UseFIPS": { + "builtIn": "AWS::UseFIPS", + "required": true, + "default": false, + "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", + "type": "Boolean" + }, + "Endpoint": { + "builtIn": "SDK::Endpoint", + "required": false, + "documentation": "Override the endpoint used to send this request", + "type": "String" + } + }, + "rules": [ + { + "conditions": [ + { + "fn": "isSet", + "argv": [ + { + "ref": "Endpoint" + } + ] + } + ], + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], + "error": "Invalid Configuration: FIPS and custom endpoint are not supported", + "type": "error" + }, + { + "conditions": [], + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] + } + ], + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", + "type": "error" + }, + { + "conditions": [], + "endpoint": { + "url": { + "ref": "Endpoint" + }, + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ], + "type": "tree" + } + ], + "type": "tree" + }, + { + "conditions": [], + "rules": [ + { + "conditions": [ + { + "fn": "isSet", + "argv": [ + { + "ref": "Region" + } + ] + } + ], + "rules": [ + { + "conditions": [ + { + "fn": "aws.partition", + "argv": [ + { + "ref": "Region" + } + ], + "assign": "PartitionResult" + } + ], + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + }, + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] + } + ], + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } + ] + }, + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsDualStack" + ] + } + ] + } + ], + "rules": [ + { + "conditions": [], + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://ssm-quicksetup-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ], + "type": "tree" + } + ], + "type": "tree" + }, + { + "conditions": [], + "error": "FIPS and DualStack are enabled, but this partition does not support one or both", + "type": "error" + } + ], + "type": "tree" + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + }, + true + ] + } + ], + "rules": [ + { + "conditions": [], + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://ssm-quicksetup-fips.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ], + "type": "tree" + } + ], + "type": "tree" + }, + { + "conditions": [], + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" + } + ], + "type": "tree" + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] + } + ], + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsDualStack" + ] + } + ] + } + ], + "rules": [ + { + "conditions": [], + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://ssm-quicksetup.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ], + "type": "tree" + } + ], + "type": "tree" + }, + { + "conditions": [], + "error": "DualStack is enabled but this partition does not support DualStack", + "type": "error" + } + ], + "type": "tree" + }, + { + "conditions": [], + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://ssm-quicksetup.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ], + "type": "tree" + } + ], + "type": "tree" + } + ], + "type": "tree" + }, + { + "conditions": [], + "error": "Invalid Configuration: Missing Region", + "type": "error" + } + ], + "type": "tree" + } + ] +} \ No newline at end of file diff --git a/apis/ssm-quicksetup/2018-05-10/endpoint-tests-1.json b/apis/ssm-quicksetup/2018-05-10/endpoint-tests-1.json new file mode 100644 index 00000000000..7397c011382 --- /dev/null +++ b/apis/ssm-quicksetup/2018-05-10/endpoint-tests-1.json @@ -0,0 +1,314 @@ +{ + "testCases": [ + { + "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.us-east-1.api.aws" + } + }, + "params": { + "Region": "us-east-1", + "UseFIPS": true, + "UseDualStack": true + } + }, + { + "documentation": "For region us-east-1 with FIPS enabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.us-east-1.amazonaws.com" + } + }, + "params": { + "Region": "us-east-1", + "UseFIPS": true, + "UseDualStack": false + } + }, + { + "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.us-east-1.api.aws" + } + }, + "params": { + "Region": "us-east-1", + "UseFIPS": false, + "UseDualStack": true + } + }, + { + "documentation": "For region us-east-1 with FIPS disabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.us-east-1.amazonaws.com" + } + }, + "params": { + "Region": "us-east-1", + "UseFIPS": false, + "UseDualStack": false + } + }, + { + "documentation": "For region cn-north-1 with FIPS enabled and DualStack enabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.cn-north-1.api.amazonwebservices.com.cn" + } + }, + "params": { + "Region": "cn-north-1", + "UseFIPS": true, + "UseDualStack": true + } + }, + { + "documentation": "For region cn-north-1 with FIPS enabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.cn-north-1.amazonaws.com.cn" + } + }, + "params": { + "Region": "cn-north-1", + "UseFIPS": true, + "UseDualStack": false + } + }, + { + "documentation": "For region cn-north-1 with FIPS disabled and DualStack enabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.cn-north-1.api.amazonwebservices.com.cn" + } + }, + "params": { + "Region": "cn-north-1", + "UseFIPS": false, + "UseDualStack": true + } + }, + { + "documentation": "For region cn-north-1 with FIPS disabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.cn-north-1.amazonaws.com.cn" + } + }, + "params": { + "Region": "cn-north-1", + "UseFIPS": false, + "UseDualStack": false + } + }, + { + "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack enabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.us-gov-east-1.api.aws" + } + }, + "params": { + "Region": "us-gov-east-1", + "UseFIPS": true, + "UseDualStack": true + } + }, + { + "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.us-gov-east-1.amazonaws.com" + } + }, + "params": { + "Region": "us-gov-east-1", + "UseFIPS": true, + "UseDualStack": false + } + }, + { + "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack enabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.us-gov-east-1.api.aws" + } + }, + "params": { + "Region": "us-gov-east-1", + "UseFIPS": false, + "UseDualStack": true + } + }, + { + "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.us-gov-east-1.amazonaws.com" + } + }, + "params": { + "Region": "us-gov-east-1", + "UseFIPS": false, + "UseDualStack": false + } + }, + { + "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack enabled", + "expect": { + "error": "FIPS and DualStack are enabled, but this partition does not support one or both" + }, + "params": { + "Region": "us-iso-east-1", + "UseFIPS": true, + "UseDualStack": true + } + }, + { + "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.us-iso-east-1.c2s.ic.gov" + } + }, + "params": { + "Region": "us-iso-east-1", + "UseFIPS": true, + "UseDualStack": false + } + }, + { + "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack enabled", + "expect": { + "error": "DualStack is enabled but this partition does not support DualStack" + }, + "params": { + "Region": "us-iso-east-1", + "UseFIPS": false, + "UseDualStack": true + } + }, + { + "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.us-iso-east-1.c2s.ic.gov" + } + }, + "params": { + "Region": "us-iso-east-1", + "UseFIPS": false, + "UseDualStack": false + } + }, + { + "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack enabled", + "expect": { + "error": "FIPS and DualStack are enabled, but this partition does not support one or both" + }, + "params": { + "Region": "us-isob-east-1", + "UseFIPS": true, + "UseDualStack": true + } + }, + { + "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup-fips.us-isob-east-1.sc2s.sgov.gov" + } + }, + "params": { + "Region": "us-isob-east-1", + "UseFIPS": true, + "UseDualStack": false + } + }, + { + "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack enabled", + "expect": { + "error": "DualStack is enabled but this partition does not support DualStack" + }, + "params": { + "Region": "us-isob-east-1", + "UseFIPS": false, + "UseDualStack": true + } + }, + { + "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack disabled", + "expect": { + "endpoint": { + "url": "https://ssm-quicksetup.us-isob-east-1.sc2s.sgov.gov" + } + }, + "params": { + "Region": "us-isob-east-1", + "UseFIPS": false, + "UseDualStack": false + } + }, + { + "documentation": "For custom endpoint with region set and fips disabled and dualstack disabled", + "expect": { + "endpoint": { + "url": "https://example.com" + } + }, + "params": { + "Region": "us-east-1", + "UseFIPS": false, + "UseDualStack": false, + "Endpoint": "https://example.com" + } + }, + { + "documentation": "For custom endpoint with region not set and fips disabled and dualstack disabled", + "expect": { + "endpoint": { + "url": "https://example.com" + } + }, + "params": { + "UseFIPS": false, + "UseDualStack": false, + "Endpoint": "https://example.com" + } + }, + { + "documentation": "For custom endpoint with fips enabled and dualstack disabled", + "expect": { + "error": "Invalid Configuration: FIPS and custom endpoint are not supported" + }, + "params": { + "Region": "us-east-1", + "UseFIPS": true, + "UseDualStack": false, + "Endpoint": "https://example.com" + } + }, + { + "documentation": "For custom endpoint with fips disabled and dualstack enabled", + "expect": { + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported" + }, + "params": { + "Region": "us-east-1", + "UseFIPS": false, + "UseDualStack": true, + "Endpoint": "https://example.com" + } + }, + { + "documentation": "Missing region", + "expect": { + "error": "Invalid Configuration: Missing Region" + } + } + ], + "version": "1.0" +} \ No newline at end of file diff --git a/apis/ssm-quicksetup/2018-05-10/examples-1.json b/apis/ssm-quicksetup/2018-05-10/examples-1.json new file mode 100644 index 00000000000..0ea7e3b0bbe --- /dev/null +++ b/apis/ssm-quicksetup/2018-05-10/examples-1.json @@ -0,0 +1,5 @@ +{ + "version": "1.0", + "examples": { + } +} diff --git a/apis/ssm-quicksetup/2018-05-10/paginators-1.json b/apis/ssm-quicksetup/2018-05-10/paginators-1.json new file mode 100644 index 00000000000..da5d6c97f70 --- /dev/null +++ b/apis/ssm-quicksetup/2018-05-10/paginators-1.json @@ -0,0 +1,10 @@ +{ + "pagination": { + "ListConfigurationManagers": { + "input_token": "StartingToken", + "output_token": "NextToken", + "limit_key": "MaxItems", + "result_key": "ConfigurationManagersList" + } + } +} diff --git a/apis/support/2013-04-15/docs-2.json b/apis/support/2013-04-15/docs-2.json index 4240140631d..57d2ad087b2 100644 --- a/apis/support/2013-04-15/docs-2.json +++ b/apis/support/2013-04-15/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "Amazon Web Services Support

The Amazon Web Services Support API Reference is intended for programmers who need detailed information about the Amazon Web Services Support operations and data types. You can use the API to manage your support cases programmatically. The Amazon Web Services Support API uses HTTP methods that return results in JSON format.

You can also use the Amazon Web Services Support API to access features for Trusted Advisor. You can return a list of checks and their descriptions, get check results, specify checks to refresh, and get the refresh status of checks.

You can manage your support cases with the following Amazon Web Services Support API operations:

You can also use the Amazon Web Services Support API to call the Trusted Advisor operations. For more information, see Trusted Advisor in the Amazon Web Services Support User Guide.

For authentication of requests, Amazon Web Services Support uses Signature Version 4 Signing Process.

For more information about this service and the endpoints to use, see About the Amazon Web Services Support API in the Amazon Web Services Support User Guide.

", + "service": "Amazon Web Services Support

The Amazon Web Services Support API Reference is intended for programmers who need detailed information about the Amazon Web Services Support operations and data types. You can use the API to manage your support cases programmatically. The Amazon Web Services Support API uses HTTP methods that return results in JSON format.

You can also use the Amazon Web Services Support API to access features for Trusted Advisor. You can return a list of checks and their descriptions, get check results, specify checks to refresh, and get the refresh status of checks.

You can manage your support cases with the following Amazon Web Services Support API operations:

You can also use the Amazon Web Services Support API to call the Trusted Advisor operations. For more information, see Trusted Advisor in the Amazon Web Services Support User Guide.

For authentication of requests, Amazon Web Services Support uses Signature Version 4 Signing Process.

For more information about this service and the endpoints to use, see About the Amazon Web Services Support API in the Amazon Web Services Support User Guide.

", "operations": { "AddAttachmentsToSet": "

Adds one or more attachments to an attachment set.

An attachment set is a temporary container for attachments that you add to a case or case communication. The set is available for 1 hour after it's created. The expiryTime returned in the response is when the set expires.

", "AddCommunicationToCase": "

Adds additional customer communication to an Amazon Web Services Support case. Use the caseId parameter to identify the case to which to add communication. You can list a set of email addresses to copy on the communication by using the ccEmailAddresses parameter. The communicationBody value contains the text of the communication.

", @@ -48,7 +48,7 @@ } }, "Attachment": { - "base": "

An attachment to a case communication. The attachment consists of the file name and the content of the file.

", + "base": "

An attachment to a case communication. The attachment consists of the file name and the content of the file. Each attachment file size should not exceed 5 MB. File types that are supported include the following: pdf, jpeg,.doc, .log, .text

", "refs": { "Attachments$member": null, "DescribeAttachmentResponse$attachment": "

This object includes the attachment content and file name.

In the previous response syntax, the value for the data parameter appears as blob, which is represented as a base64-encoded string. The value for fileName is the name of the attachment, such as troubleshoot-screenshot.png.

" @@ -139,7 +139,7 @@ } }, "CaseDetails": { - "base": "

A JSON-formatted object that contains the metadata for a support case. It is contained in the response from a DescribeCases request. CaseDetails contains the following fields:

", + "base": "

A JSON-formatted object that contains the metadata for a support case. It is contained in the response from a DescribeCases request. CaseDetails contains the following fields:

", "refs": { "CaseList$member": null } @@ -624,7 +624,7 @@ "Status": { "base": null, "refs": { - "CaseDetails$status": "

The status of the case.

Valid values:

" + "CaseDetails$status": "

The status of the case.

Valid values:

" } }, "String": { diff --git a/gems/aws-partitions/CHANGELOG.md b/gems/aws-partitions/CHANGELOG.md index 5dca55fddd3..1b2dd8fcde4 100644 --- a/gems/aws-partitions/CHANGELOG.md +++ b/gems/aws-partitions/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.961.0 (2024-08-01) +------------------ + +* Feature - Added support for enumerating regions for `Aws::SSMQuickSetup`. + 1.960.0 (2024-07-30) ------------------ diff --git a/gems/aws-partitions/VERSION b/gems/aws-partitions/VERSION index 3fa5a10ea9f..20a74df229e 100644 --- a/gems/aws-partitions/VERSION +++ b/gems/aws-partitions/VERSION @@ -1 +1 @@ -1.960.0 +1.961.0 diff --git a/gems/aws-partitions/lib/aws-partitions.rb b/gems/aws-partitions/lib/aws-partitions.rb index dad788d501e..052001b7f0d 100644 --- a/gems/aws-partitions/lib/aws-partitions.rb +++ b/gems/aws-partitions/lib/aws-partitions.rb @@ -569,6 +569,7 @@ def service_ids 'SSM' => 'ssm', 'SSMContacts' => 'ssm-contacts', 'SSMIncidents' => 'ssm-incidents', + 'SSMQuickSetup' => 'ssm-quicksetup', 'SSO' => 'portal.sso', 'SSOAdmin' => 'sso', 'SSOOIDC' => 'oidc', diff --git a/gems/aws-sdk-bedrock/CHANGELOG.md b/gems/aws-sdk-bedrock/CHANGELOG.md index 56b091ec2eb..3bb7eeda075 100644 --- a/gems/aws-sdk-bedrock/CHANGELOG.md +++ b/gems/aws-sdk-bedrock/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.14.0 (2024-08-01) +------------------ + +* Feature - API and Documentation for Bedrock Model Copy feature. This feature lets you share and copy a custom model from one region to another or one account to another. + 1.13.0 (2024-07-18) ------------------ diff --git a/gems/aws-sdk-bedrock/VERSION b/gems/aws-sdk-bedrock/VERSION index feaae22bac7..850e742404b 100644 --- a/gems/aws-sdk-bedrock/VERSION +++ b/gems/aws-sdk-bedrock/VERSION @@ -1 +1 @@ -1.13.0 +1.14.0 diff --git a/gems/aws-sdk-bedrock/aws-sdk-bedrock.gemspec b/gems/aws-sdk-bedrock/aws-sdk-bedrock.gemspec index f9db4a5a9f8..9641096285d 100644 --- a/gems/aws-sdk-bedrock/aws-sdk-bedrock.gemspec +++ b/gems/aws-sdk-bedrock/aws-sdk-bedrock.gemspec @@ -26,7 +26,7 @@ Gem::Specification.new do |spec| } spec.add_dependency('aws-sdk-core', '~> 3', '>= 3.201.0') - spec.add_dependency('aws-sigv4', '~> 1.1') + spec.add_dependency('aws-sigv4', '~> 1.5') spec.required_ruby_version = '>= 2.5' end diff --git a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock.rb b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock.rb index f90a607d19a..25e1399e5f1 100644 --- a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock.rb +++ b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock.rb @@ -53,6 +53,6 @@ # @!group service module Aws::Bedrock - GEM_VERSION = '1.13.0' + GEM_VERSION = '1.14.0' end diff --git a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client.rb b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client.rb index 237780cd7b9..9017a3ccf64 100644 --- a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client.rb +++ b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client.rb @@ -428,7 +428,7 @@ def initialize(*args) # API operation for creating and managing Amazon Bedrock automatic model # evaluation jobs and model evaluation jobs that use human workers. To # learn more about the requirements for creating a model evaluation job - # see, [Model evaluations][1]. + # see, [Model evaluation][1]. # # # @@ -801,6 +801,78 @@ def create_guardrail_version(params = {}, options = {}) req.send_request(options) end + # Copies a model to another region so that it can be used there. For + # more information, see [Copy models to be used in other regions][1] in + # the [Amazon Bedrock User Guide][2]. + # + # + # + # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/copy-model.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html + # + # @option params [required, String] :source_model_arn + # The Amazon Resource Name (ARN) of the model to be copied. + # + # @option params [required, String] :target_model_name + # A name for the copied model. + # + # @option params [String] :model_kms_key_id + # The ARN of the KMS key that you use to encrypt the model copy. + # + # @option params [Array] :target_model_tags + # Tags to associate with the target model. For more information, see + # [Tag resources][1] in the [Amazon Bedrock User Guide][2]. + # + # + # + # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html + # + # @option params [String] :client_request_token + # A unique, case-sensitive identifier to ensure that the API request + # completes no more than one time. If this token matches a previous + # request, Amazon Bedrock ignores the request, but does not return an + # error. For more information, see [Ensuring idempotency][1]. + # + # **A suitable default value is auto-generated.** You should normally + # not need to pass this option.** + # + # + # + # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html + # + # @return [Types::CreateModelCopyJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::CreateModelCopyJobResponse#job_arn #job_arn} => String + # + # @example Request syntax with placeholder values + # + # resp = client.create_model_copy_job({ + # source_model_arn: "ModelArn", # required + # target_model_name: "CustomModelName", # required + # model_kms_key_id: "KmsKeyId", + # target_model_tags: [ + # { + # key: "TagKey", # required + # value: "TagValue", # required + # }, + # ], + # client_request_token: "IdempotencyToken", + # }) + # + # @example Response structure + # + # resp.job_arn #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/CreateModelCopyJob AWS API Documentation + # + # @overload create_model_copy_job(params = {}) + # @param [Hash] params ({}) + def create_model_copy_job(params = {}, options = {}) + req = build_request(:create_model_copy_job, params) + req.send_request(options) + end + # Creates a fine-tuning job to customize a base model. # # You specify the base foundation model and the location of the training @@ -817,13 +889,14 @@ def create_guardrail_version(params = {}, options = {}) # monitor a job, use the `GetModelCustomizationJob` operation to # retrieve the job status. # - # For more information, see [Custom models][2] in the Amazon Bedrock - # User Guide. + # For more information, see [Custom models][2] in the [Amazon Bedrock + # User Guide][3]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-customization-prepare.html # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :job_name # A name for the fine-tuning job. @@ -953,12 +1026,13 @@ def create_model_customization_job(params = {}, options = {}) # Creates dedicated throughput for a base or custom model with the model # units and for the duration that you specify. For pricing details, see # [Amazon Bedrock Pricing][1]. For more information, see [Provisioned - # Throughput][2] in the Amazon Bedrock User Guide. + # Throughput][2] in the [Amazon Bedrock User Guide][3]. # # # # [1]: http://aws.amazon.com/bedrock/pricing/ # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html + # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [String] :client_request_token # A unique, case-sensitive identifier to ensure that the API request @@ -984,7 +1058,7 @@ def create_model_customization_job(params = {}, options = {}) # center][1] to request MUs. # # For model unit quotas, see [Provisioned Throughput quotas][2] in the - # Amazon Bedrock User Guide. + # [Amazon Bedrock User Guide][3]. # # For more information about what an MU specifies, contact your Amazon # Web Services account manager. @@ -993,6 +1067,7 @@ def create_model_customization_job(params = {}, options = {}) # # [1]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/quotas.html#prov-thru-quotas + # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :provisioned_model_name # The name for this Provisioned Throughput. @@ -1001,12 +1076,13 @@ def create_model_customization_job(params = {}, options = {}) # The Amazon Resource Name (ARN) or name of the model to associate with # this Provisioned Throughput. For a list of models for which you can # purchase Provisioned Throughput, see [Amazon Bedrock model IDs for - # purchasing Provisioned Throughput][1] in the Amazon Bedrock User - # Guide. + # purchasing Provisioned Throughput][1] in the [Amazon Bedrock User + # Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#prov-throughput-models + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [String] :commitment_duration # The commitment duration requested for the Provisioned Throughput. @@ -1015,11 +1091,12 @@ def create_model_customization_job(params = {}, options = {}) # # Custom models support all levels of commitment. To see which base # models support no commitment, see [Supported regions and models for - # Provisioned Throughput][1] in the Amazon Bedrock User Guide + # Provisioned Throughput][1] in the [Amazon Bedrock User Guide][2] # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/pt-supported.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [Array] :tags # Tags to associate with this Provisioned Throughput. @@ -1058,11 +1135,12 @@ def create_provisioned_model_throughput(params = {}, options = {}) end # Deletes a custom model that you created earlier. For more information, - # see [Custom models][1] in the Amazon Bedrock User Guide. + # see [Custom models][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :model_identifier # Name of the model to delete. @@ -1133,11 +1211,12 @@ def delete_model_invocation_logging_configuration(params = {}, options = {}) # Deletes a Provisioned Throughput. You can't delete a Provisioned # Throughput before the commitment term is over. For more information, - # see [Provisioned Throughput][1] in the Amazon Bedrock User Guide. + # see [Provisioned Throughput][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :provisioned_model_id # The Amazon Resource Name (ARN) or name of the Provisioned Throughput. @@ -1161,11 +1240,12 @@ def delete_provisioned_model_throughput(params = {}, options = {}) # Get the properties associated with a Amazon Bedrock custom model that # you have created.For more information, see [Custom models][1] in the - # Amazon Bedrock User Guide. + # [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :model_identifier # Name or Amazon Resource Name (ARN) of the custom model. @@ -1224,11 +1304,11 @@ def get_custom_model(params = {}, options = {}) # Retrieves the properties associated with a model evaluation job, # including the status of the job. For more information, see [Model - # evaluations][1]. + # evaluation][1]. # # # - # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/latest/userguide/model-evaluation.html + # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-evaluation.html # # @option params [required, String] :job_identifier # The Amazon Resource Name (ARN) of the model evaluation job. @@ -1433,13 +1513,71 @@ def get_guardrail(params = {}, options = {}) req.send_request(options) end + # Retrieves information about a model copy job. For more information, + # see [Copy models to be used in other regions][1] in the [Amazon + # Bedrock User Guide][2]. + # + # + # + # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/copy-model.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html + # + # @option params [required, String] :job_arn + # The Amazon Resource Name (ARN) of the model copy job. + # + # @return [Types::GetModelCopyJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::GetModelCopyJobResponse#job_arn #job_arn} => String + # * {Types::GetModelCopyJobResponse#status #status} => String + # * {Types::GetModelCopyJobResponse#creation_time #creation_time} => Time + # * {Types::GetModelCopyJobResponse#target_model_arn #target_model_arn} => String + # * {Types::GetModelCopyJobResponse#target_model_name #target_model_name} => String + # * {Types::GetModelCopyJobResponse#source_account_id #source_account_id} => String + # * {Types::GetModelCopyJobResponse#source_model_arn #source_model_arn} => String + # * {Types::GetModelCopyJobResponse#target_model_kms_key_arn #target_model_kms_key_arn} => String + # * {Types::GetModelCopyJobResponse#target_model_tags #target_model_tags} => Array<Types::Tag> + # * {Types::GetModelCopyJobResponse#failure_message #failure_message} => String + # * {Types::GetModelCopyJobResponse#source_model_name #source_model_name} => String + # + # @example Request syntax with placeholder values + # + # resp = client.get_model_copy_job({ + # job_arn: "ModelCopyJobArn", # required + # }) + # + # @example Response structure + # + # resp.job_arn #=> String + # resp.status #=> String, one of "InProgress", "Completed", "Failed" + # resp.creation_time #=> Time + # resp.target_model_arn #=> String + # resp.target_model_name #=> String + # resp.source_account_id #=> String + # resp.source_model_arn #=> String + # resp.target_model_kms_key_arn #=> String + # resp.target_model_tags #=> Array + # resp.target_model_tags[0].key #=> String + # resp.target_model_tags[0].value #=> String + # resp.failure_message #=> String + # resp.source_model_name #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GetModelCopyJob AWS API Documentation + # + # @overload get_model_copy_job(params = {}) + # @param [Hash] params ({}) + def get_model_copy_job(params = {}, options = {}) + req = build_request(:get_model_copy_job, params) + req.send_request(options) + end + # Retrieves the properties associated with a model-customization job, # including the status of the job. For more information, see [Custom - # models][1] in the Amazon Bedrock User Guide. + # models][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :job_identifier # Identifier for the customization job. @@ -1541,11 +1679,12 @@ def get_model_invocation_logging_configuration(params = {}, options = {}) end # Returns details for a Provisioned Throughput. For more information, - # see [Provisioned Throughput][1] in the Amazon Bedrock User Guide. + # see [Provisioned Throughput][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :provisioned_model_id # The Amazon Resource Name (ARN) or name of the Provisioned Throughput. @@ -1600,12 +1739,13 @@ def get_provisioned_model_throughput(params = {}, options = {}) # Returns a list of the custom models that you have created with the # `CreateModelCustomizationJob` operation. # - # For more information, see [Custom models][1] in the Amazon Bedrock - # User Guide. + # For more information, see [Custom models][1] in the [Amazon Bedrock + # User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [Time,DateTime,Date,Integer,String] :creation_time_before # Return custom models created before the specified time. @@ -1625,11 +1765,16 @@ def get_provisioned_model_throughput(params = {}, options = {}) # (ARN) matches this parameter. # # @option params [Integer] :max_results - # Maximum number of results to return in the response. + # The maximum number of results to return in the response. If the total + # number of results is greater than this value, use the token returned + # in the response in the `nextToken` field when making another request + # to return the next batch of results. # # @option params [String] :next_token - # Continuation token from the previous response, for Amazon Bedrock to - # list the next set of results. + # If the total number of results is greater than the `maxResults` value + # provided in the request, enter the token returned in the `nextToken` + # field in the response in this field to return the next batch of + # results. # # @option params [String] :sort_by # The field to sort by in the returned list of models. @@ -1637,6 +1782,10 @@ def get_provisioned_model_throughput(params = {}, options = {}) # @option params [String] :sort_order # The sort order of the results. # + # @option params [Boolean] :is_owned + # Return custom models depending on if the current account owns them + # (`true`) or if they were shared with the current account (`false`). + # # @return [Types::ListCustomModelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::ListCustomModelsResponse#next_token #next_token} => String @@ -1656,6 +1805,7 @@ def get_provisioned_model_throughput(params = {}, options = {}) # next_token: "PaginationToken", # sort_by: "CreationTime", # accepts CreationTime # sort_order: "Ascending", # accepts Ascending, Descending + # is_owned: false, # }) # # @example Response structure @@ -1668,6 +1818,7 @@ def get_provisioned_model_throughput(params = {}, options = {}) # resp.model_summaries[0].base_model_arn #=> String # resp.model_summaries[0].base_model_name #=> String # resp.model_summaries[0].customization_type #=> String, one of "FINE_TUNING", "CONTINUED_PRE_TRAINING" + # resp.model_summaries[0].owner_account_id #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/ListCustomModels AWS API Documentation # @@ -1752,35 +1903,38 @@ def list_evaluation_jobs(params = {}, options = {}) # Lists Amazon Bedrock foundation models that you can use. You can # filter the results with the request parameters. For more information, - # see [Foundation models][1] in the Amazon Bedrock User Guide. + # see [Foundation models][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/foundation-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [String] :by_provider # Return models belonging to the model provider that you specify. # # @option params [String] :by_customization_type # Return models that support the customization type that you specify. - # For more information, see [Custom models][1] in the Amazon Bedrock - # User Guide. + # For more information, see [Custom models][1] in the [Amazon Bedrock + # User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [String] :by_output_modality # Return models that support the output modality that you specify. # # @option params [String] :by_inference_type # Return models that support the inference type that you specify. For - # more information, see [Provisioned Throughput][1] in the Amazon - # Bedrock User Guide. + # more information, see [Provisioned Throughput][1] in the [Amazon + # Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @return [Types::ListFoundationModelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -1880,15 +2034,116 @@ def list_guardrails(params = {}, options = {}) req.send_request(options) end + # Returns a list of model copy jobs that you have submitted. You can + # filter the jobs to return based on one or more criteria. For more + # information, see [Copy models to be used in other regions][1] in the + # [Amazon Bedrock User Guide][2]. + # + # + # + # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/copy-model.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html + # + # @option params [Time,DateTime,Date,Integer,String] :creation_time_after + # Filters for model copy jobs created after the specified time. + # + # @option params [Time,DateTime,Date,Integer,String] :creation_time_before + # Filters for model copy jobs created before the specified time. + # + # @option params [String] :status_equals + # Filters for model copy jobs whose status matches the value that you + # specify. + # + # @option params [String] :source_account_equals + # Filters for model copy jobs in which the account that the source model + # belongs to is equal to the value that you specify. + # + # @option params [String] :source_model_arn_equals + # Filters for model copy jobs in which the Amazon Resource Name (ARN) of + # the source model to is equal to the value that you specify. + # + # @option params [String] :target_model_name_contains + # Filters for model copy jobs in which the name of the copied model + # contains the string that you specify. + # + # @option params [Integer] :max_results + # The maximum number of results to return in the response. If the total + # number of results is greater than this value, use the token returned + # in the response in the `nextToken` field when making another request + # to return the next batch of results. + # + # @option params [String] :next_token + # If the total number of results is greater than the `maxResults` value + # provided in the request, enter the token returned in the `nextToken` + # field in the response in this field to return the next batch of + # results. + # + # @option params [String] :sort_by + # The field to sort by in the returned list of model copy jobs. + # + # @option params [String] :sort_order + # Specifies whether to sort the results in ascending or descending + # order. + # + # @return [Types::ListModelCopyJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::ListModelCopyJobsResponse#next_token #next_token} => String + # * {Types::ListModelCopyJobsResponse#model_copy_job_summaries #model_copy_job_summaries} => Array<Types::ModelCopyJobSummary> + # + # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. + # + # @example Request syntax with placeholder values + # + # resp = client.list_model_copy_jobs({ + # creation_time_after: Time.now, + # creation_time_before: Time.now, + # status_equals: "InProgress", # accepts InProgress, Completed, Failed + # source_account_equals: "AccountId", + # source_model_arn_equals: "ModelArn", + # target_model_name_contains: "CustomModelName", + # max_results: 1, + # next_token: "PaginationToken", + # sort_by: "CreationTime", # accepts CreationTime + # sort_order: "Ascending", # accepts Ascending, Descending + # }) + # + # @example Response structure + # + # resp.next_token #=> String + # resp.model_copy_job_summaries #=> Array + # resp.model_copy_job_summaries[0].job_arn #=> String + # resp.model_copy_job_summaries[0].status #=> String, one of "InProgress", "Completed", "Failed" + # resp.model_copy_job_summaries[0].creation_time #=> Time + # resp.model_copy_job_summaries[0].target_model_arn #=> String + # resp.model_copy_job_summaries[0].target_model_name #=> String + # resp.model_copy_job_summaries[0].source_account_id #=> String + # resp.model_copy_job_summaries[0].source_model_arn #=> String + # resp.model_copy_job_summaries[0].target_model_kms_key_arn #=> String + # resp.model_copy_job_summaries[0].target_model_tags #=> Array + # resp.model_copy_job_summaries[0].target_model_tags[0].key #=> String + # resp.model_copy_job_summaries[0].target_model_tags[0].value #=> String + # resp.model_copy_job_summaries[0].failure_message #=> String + # resp.model_copy_job_summaries[0].source_model_name #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/ListModelCopyJobs AWS API Documentation + # + # @overload list_model_copy_jobs(params = {}) + # @param [Hash] params ({}) + def list_model_copy_jobs(params = {}, options = {}) + req = build_request(:list_model_copy_jobs, params) + req.send_request(options) + end + # Returns a list of model customization jobs that you have submitted. # You can filter the jobs to return based on one or more criteria. # - # For more information, see [Custom models][1] in the Amazon Bedrock - # User Guide. + # For more information, see [Custom models][1] in the [Amazon Bedrock + # User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [Time,DateTime,Date,Integer,String] :creation_time_after # Return customization jobs created after the specified time. @@ -1904,11 +2159,16 @@ def list_guardrails(params = {}, options = {}) # characters. # # @option params [Integer] :max_results - # Maximum number of results to return in the response. + # The maximum number of results to return in the response. If the total + # number of results is greater than this value, use the token returned + # in the response in the `nextToken` field when making another request + # to return the next batch of results. # # @option params [String] :next_token - # Continuation token from the previous response, for Amazon Bedrock to - # list the next set of results. + # If the total number of results is greater than the `maxResults` value + # provided in the request, enter the token returned in the `nextToken` + # field in the response in this field to return the next batch of + # results. # # @option params [String] :sort_by # The field to sort by in the returned list of jobs. @@ -1961,12 +2221,13 @@ def list_model_customization_jobs(params = {}, options = {}) end # Lists the Provisioned Throughputs in the account. For more - # information, see [Provisioned Throughput][1] in the Amazon Bedrock - # User Guide. + # information, see [Provisioned Throughput][1] in the [Amazon Bedrock + # User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [Time,DateTime,Date,Integer,String] :creation_time_after # A filter that returns Provisioned Throughputs created after the @@ -2056,12 +2317,13 @@ def list_provisioned_model_throughputs(params = {}, options = {}) # List the tags associated with the specified resource. # - # For more information, see [Tagging resources][1] in the Amazon Bedrock - # User Guide. + # For more information, see [Tagging resources][1] in the [Amazon + # Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :resource_arn # The Amazon Resource Name (ARN) of the resource. @@ -2152,11 +2414,12 @@ def stop_evaluation_job(params = {}, options = {}) end # Stops an active model customization job. For more information, see - # [Custom models][1] in the Amazon Bedrock User Guide. + # [Custom models][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :job_identifier # Job identifier of the job to stop. @@ -2179,11 +2442,12 @@ def stop_model_customization_job(params = {}, options = {}) end # Associate tags with a resource. For more information, see [Tagging - # resources][1] in the Amazon Bedrock User Guide. + # resources][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :resource_arn # The Amazon Resource Name (ARN) of the resource to tag. @@ -2215,11 +2479,12 @@ def tag_resource(params = {}, options = {}) end # Remove one or more tags from a resource. For more information, see - # [Tagging resources][1] in the Amazon Bedrock User Guide. + # [Tagging resources][1] in the [Amazon Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :resource_arn # The Amazon Resource Name (ARN) of the resource to untag. @@ -2411,12 +2676,13 @@ def update_guardrail(params = {}, options = {}) end # Updates the name or associated model for a Provisioned Throughput. For - # more information, see [Provisioned Throughput][1] in the Amazon - # Bedrock User Guide. + # more information, see [Provisioned Throughput][1] in the [Amazon + # Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # # @option params [required, String] :provisioned_model_id # The Amazon Resource Name (ARN) or name of the Provisioned Throughput @@ -2470,7 +2736,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-bedrock' - context[:gem_version] = '1.13.0' + context[:gem_version] = '1.14.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client_api.rb b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client_api.rb index ae50f112955..4d0bbb1b132 100644 --- a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client_api.rb +++ b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/client_api.rb @@ -14,6 +14,7 @@ module ClientApi include Seahorse::Model AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException') + AccountId = Shapes::StringShape.new(name: 'AccountId') AutomatedEvaluationConfig = Shapes::StructureShape.new(name: 'AutomatedEvaluationConfig') BaseModelIdentifier = Shapes::StringShape.new(name: 'BaseModelIdentifier') BedrockModelId = Shapes::StringShape.new(name: 'BedrockModelId') @@ -29,6 +30,8 @@ module ClientApi CreateGuardrailResponse = Shapes::StructureShape.new(name: 'CreateGuardrailResponse') CreateGuardrailVersionRequest = Shapes::StructureShape.new(name: 'CreateGuardrailVersionRequest') CreateGuardrailVersionResponse = Shapes::StructureShape.new(name: 'CreateGuardrailVersionResponse') + CreateModelCopyJobRequest = Shapes::StructureShape.new(name: 'CreateModelCopyJobRequest') + CreateModelCopyJobResponse = Shapes::StructureShape.new(name: 'CreateModelCopyJobResponse') CreateModelCustomizationJobRequest = Shapes::StructureShape.new(name: 'CreateModelCustomizationJobRequest') CreateModelCustomizationJobResponse = Shapes::StructureShape.new(name: 'CreateModelCustomizationJobResponse') CreateProvisionedModelThroughputRequest = Shapes::StructureShape.new(name: 'CreateProvisionedModelThroughputRequest') @@ -91,6 +94,8 @@ module ClientApi GetFoundationModelResponse = Shapes::StructureShape.new(name: 'GetFoundationModelResponse') GetGuardrailRequest = Shapes::StructureShape.new(name: 'GetGuardrailRequest') GetGuardrailResponse = Shapes::StructureShape.new(name: 'GetGuardrailResponse') + GetModelCopyJobRequest = Shapes::StructureShape.new(name: 'GetModelCopyJobRequest') + GetModelCopyJobResponse = Shapes::StructureShape.new(name: 'GetModelCopyJobResponse') GetModelCustomizationJobRequest = Shapes::StructureShape.new(name: 'GetModelCustomizationJobRequest') GetModelCustomizationJobResponse = Shapes::StructureShape.new(name: 'GetModelCustomizationJobResponse') GetModelInvocationLoggingConfigurationRequest = Shapes::StructureShape.new(name: 'GetModelInvocationLoggingConfigurationRequest') @@ -193,6 +198,8 @@ module ClientApi ListFoundationModelsResponse = Shapes::StructureShape.new(name: 'ListFoundationModelsResponse') ListGuardrailsRequest = Shapes::StructureShape.new(name: 'ListGuardrailsRequest') ListGuardrailsResponse = Shapes::StructureShape.new(name: 'ListGuardrailsResponse') + ListModelCopyJobsRequest = Shapes::StructureShape.new(name: 'ListModelCopyJobsRequest') + ListModelCopyJobsResponse = Shapes::StructureShape.new(name: 'ListModelCopyJobsResponse') ListModelCustomizationJobsRequest = Shapes::StructureShape.new(name: 'ListModelCustomizationJobsRequest') ListModelCustomizationJobsResponse = Shapes::StructureShape.new(name: 'ListModelCustomizationJobsResponse') ListProvisionedModelThroughputsRequest = Shapes::StructureShape.new(name: 'ListProvisionedModelThroughputsRequest') @@ -204,6 +211,10 @@ module ClientApi MaxResults = Shapes::IntegerShape.new(name: 'MaxResults') MetricFloat = Shapes::FloatShape.new(name: 'MetricFloat') ModelArn = Shapes::StringShape.new(name: 'ModelArn') + ModelCopyJobArn = Shapes::StringShape.new(name: 'ModelCopyJobArn') + ModelCopyJobStatus = Shapes::StringShape.new(name: 'ModelCopyJobStatus') + ModelCopyJobSummaries = Shapes::ListShape.new(name: 'ModelCopyJobSummaries') + ModelCopyJobSummary = Shapes::StructureShape.new(name: 'ModelCopyJobSummary') ModelCustomization = Shapes::StringShape.new(name: 'ModelCustomization') ModelCustomizationHyperParameters = Shapes::MapShape.new(name: 'ModelCustomizationHyperParameters') ModelCustomizationJobArn = Shapes::StringShape.new(name: 'ModelCustomizationJobArn') @@ -332,6 +343,16 @@ module ClientApi CreateGuardrailVersionResponse.add_member(:version, Shapes::ShapeRef.new(shape: GuardrailNumericalVersion, required: true, location_name: "version")) CreateGuardrailVersionResponse.struct_class = Types::CreateGuardrailVersionResponse + CreateModelCopyJobRequest.add_member(:source_model_arn, Shapes::ShapeRef.new(shape: ModelArn, required: true, location_name: "sourceModelArn")) + CreateModelCopyJobRequest.add_member(:target_model_name, Shapes::ShapeRef.new(shape: CustomModelName, required: true, location_name: "targetModelName")) + CreateModelCopyJobRequest.add_member(:model_kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "modelKmsKeyId")) + CreateModelCopyJobRequest.add_member(:target_model_tags, Shapes::ShapeRef.new(shape: TagList, location_name: "targetModelTags")) + CreateModelCopyJobRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: IdempotencyToken, location_name: "clientRequestToken", metadata: {"idempotencyToken"=>true})) + CreateModelCopyJobRequest.struct_class = Types::CreateModelCopyJobRequest + + CreateModelCopyJobResponse.add_member(:job_arn, Shapes::ShapeRef.new(shape: ModelCopyJobArn, required: true, location_name: "jobArn")) + CreateModelCopyJobResponse.struct_class = Types::CreateModelCopyJobResponse + CreateModelCustomizationJobRequest.add_member(:job_name, Shapes::ShapeRef.new(shape: JobName, required: true, location_name: "jobName")) CreateModelCustomizationJobRequest.add_member(:custom_model_name, Shapes::ShapeRef.new(shape: CustomModelName, required: true, location_name: "customModelName")) CreateModelCustomizationJobRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "roleArn")) @@ -368,6 +389,7 @@ module ClientApi CustomModelSummary.add_member(:base_model_arn, Shapes::ShapeRef.new(shape: ModelArn, required: true, location_name: "baseModelArn")) CustomModelSummary.add_member(:base_model_name, Shapes::ShapeRef.new(shape: ModelName, required: true, location_name: "baseModelName")) CustomModelSummary.add_member(:customization_type, Shapes::ShapeRef.new(shape: CustomizationType, location_name: "customizationType")) + CustomModelSummary.add_member(:owner_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "ownerAccountId")) CustomModelSummary.struct_class = Types::CustomModelSummary CustomModelSummaryList.member = Shapes::ShapeRef.new(shape: CustomModelSummary) @@ -553,6 +575,22 @@ module ClientApi GetGuardrailResponse.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: KmsKeyArn, location_name: "kmsKeyArn")) GetGuardrailResponse.struct_class = Types::GetGuardrailResponse + GetModelCopyJobRequest.add_member(:job_arn, Shapes::ShapeRef.new(shape: ModelCopyJobArn, required: true, location: "uri", location_name: "jobArn")) + GetModelCopyJobRequest.struct_class = Types::GetModelCopyJobRequest + + GetModelCopyJobResponse.add_member(:job_arn, Shapes::ShapeRef.new(shape: ModelCopyJobArn, required: true, location_name: "jobArn")) + GetModelCopyJobResponse.add_member(:status, Shapes::ShapeRef.new(shape: ModelCopyJobStatus, required: true, location_name: "status")) + GetModelCopyJobResponse.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "creationTime")) + GetModelCopyJobResponse.add_member(:target_model_arn, Shapes::ShapeRef.new(shape: CustomModelArn, required: true, location_name: "targetModelArn")) + GetModelCopyJobResponse.add_member(:target_model_name, Shapes::ShapeRef.new(shape: CustomModelName, location_name: "targetModelName")) + GetModelCopyJobResponse.add_member(:source_account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location_name: "sourceAccountId")) + GetModelCopyJobResponse.add_member(:source_model_arn, Shapes::ShapeRef.new(shape: ModelArn, required: true, location_name: "sourceModelArn")) + GetModelCopyJobResponse.add_member(:target_model_kms_key_arn, Shapes::ShapeRef.new(shape: KmsKeyArn, location_name: "targetModelKmsKeyArn")) + GetModelCopyJobResponse.add_member(:target_model_tags, Shapes::ShapeRef.new(shape: TagList, location_name: "targetModelTags")) + GetModelCopyJobResponse.add_member(:failure_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "failureMessage")) + GetModelCopyJobResponse.add_member(:source_model_name, Shapes::ShapeRef.new(shape: CustomModelName, location_name: "sourceModelName")) + GetModelCopyJobResponse.struct_class = Types::GetModelCopyJobResponse + GetModelCustomizationJobRequest.add_member(:job_identifier, Shapes::ShapeRef.new(shape: ModelCustomizationJobIdentifier, required: true, location: "uri", location_name: "jobIdentifier")) GetModelCustomizationJobRequest.struct_class = Types::GetModelCustomizationJobRequest @@ -774,6 +812,7 @@ module ClientApi ListCustomModelsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location: "querystring", location_name: "nextToken")) ListCustomModelsRequest.add_member(:sort_by, Shapes::ShapeRef.new(shape: SortModelsBy, location: "querystring", location_name: "sortBy")) ListCustomModelsRequest.add_member(:sort_order, Shapes::ShapeRef.new(shape: SortOrder, location: "querystring", location_name: "sortOrder")) + ListCustomModelsRequest.add_member(:is_owned, Shapes::ShapeRef.new(shape: Boolean, location: "querystring", location_name: "isOwned")) ListCustomModelsRequest.struct_class = Types::ListCustomModelsRequest ListCustomModelsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken")) @@ -812,6 +851,22 @@ module ClientApi ListGuardrailsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken")) ListGuardrailsResponse.struct_class = Types::ListGuardrailsResponse + ListModelCopyJobsRequest.add_member(:creation_time_after, Shapes::ShapeRef.new(shape: Timestamp, location: "querystring", location_name: "creationTimeAfter")) + ListModelCopyJobsRequest.add_member(:creation_time_before, Shapes::ShapeRef.new(shape: Timestamp, location: "querystring", location_name: "creationTimeBefore")) + ListModelCopyJobsRequest.add_member(:status_equals, Shapes::ShapeRef.new(shape: ModelCopyJobStatus, location: "querystring", location_name: "statusEquals")) + ListModelCopyJobsRequest.add_member(:source_account_equals, Shapes::ShapeRef.new(shape: AccountId, location: "querystring", location_name: "sourceAccountEquals")) + ListModelCopyJobsRequest.add_member(:source_model_arn_equals, Shapes::ShapeRef.new(shape: ModelArn, location: "querystring", location_name: "sourceModelArnEquals")) + ListModelCopyJobsRequest.add_member(:target_model_name_contains, Shapes::ShapeRef.new(shape: CustomModelName, location: "querystring", location_name: "outputModelNameContains")) + ListModelCopyJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location: "querystring", location_name: "maxResults")) + ListModelCopyJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location: "querystring", location_name: "nextToken")) + ListModelCopyJobsRequest.add_member(:sort_by, Shapes::ShapeRef.new(shape: SortJobsBy, location: "querystring", location_name: "sortBy")) + ListModelCopyJobsRequest.add_member(:sort_order, Shapes::ShapeRef.new(shape: SortOrder, location: "querystring", location_name: "sortOrder")) + ListModelCopyJobsRequest.struct_class = Types::ListModelCopyJobsRequest + + ListModelCopyJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken")) + ListModelCopyJobsResponse.add_member(:model_copy_job_summaries, Shapes::ShapeRef.new(shape: ModelCopyJobSummaries, location_name: "modelCopyJobSummaries")) + ListModelCopyJobsResponse.struct_class = Types::ListModelCopyJobsResponse + ListModelCustomizationJobsRequest.add_member(:creation_time_after, Shapes::ShapeRef.new(shape: Timestamp, location: "querystring", location_name: "creationTimeAfter")) ListModelCustomizationJobsRequest.add_member(:creation_time_before, Shapes::ShapeRef.new(shape: Timestamp, location: "querystring", location_name: "creationTimeBefore")) ListModelCustomizationJobsRequest.add_member(:status_equals, Shapes::ShapeRef.new(shape: FineTuningJobStatus, location: "querystring", location_name: "statusEquals")) @@ -854,6 +909,21 @@ module ClientApi LoggingConfig.add_member(:embedding_data_delivery_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "embeddingDataDeliveryEnabled")) LoggingConfig.struct_class = Types::LoggingConfig + ModelCopyJobSummaries.member = Shapes::ShapeRef.new(shape: ModelCopyJobSummary) + + ModelCopyJobSummary.add_member(:job_arn, Shapes::ShapeRef.new(shape: ModelCopyJobArn, required: true, location_name: "jobArn")) + ModelCopyJobSummary.add_member(:status, Shapes::ShapeRef.new(shape: ModelCopyJobStatus, required: true, location_name: "status")) + ModelCopyJobSummary.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "creationTime")) + ModelCopyJobSummary.add_member(:target_model_arn, Shapes::ShapeRef.new(shape: CustomModelArn, required: true, location_name: "targetModelArn")) + ModelCopyJobSummary.add_member(:target_model_name, Shapes::ShapeRef.new(shape: CustomModelName, location_name: "targetModelName")) + ModelCopyJobSummary.add_member(:source_account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location_name: "sourceAccountId")) + ModelCopyJobSummary.add_member(:source_model_arn, Shapes::ShapeRef.new(shape: ModelArn, required: true, location_name: "sourceModelArn")) + ModelCopyJobSummary.add_member(:target_model_kms_key_arn, Shapes::ShapeRef.new(shape: KmsKeyArn, location_name: "targetModelKmsKeyArn")) + ModelCopyJobSummary.add_member(:target_model_tags, Shapes::ShapeRef.new(shape: TagList, location_name: "targetModelTags")) + ModelCopyJobSummary.add_member(:failure_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "failureMessage")) + ModelCopyJobSummary.add_member(:source_model_name, Shapes::ShapeRef.new(shape: CustomModelName, location_name: "sourceModelName")) + ModelCopyJobSummary.struct_class = Types::ModelCopyJobSummary + ModelCustomizationHyperParameters.key = Shapes::ShapeRef.new(shape: String) ModelCustomizationHyperParameters.value = Shapes::ShapeRef.new(shape: String) @@ -1010,9 +1080,10 @@ module ClientApi api.metadata = { "apiVersion" => "2023-04-20", + "auth" => ["aws.auth#sigv4"], "endpointPrefix" => "bedrock", - "jsonVersion" => "1.1", "protocol" => "rest-json", + "protocols" => ["rest-json"], "serviceFullName" => "Amazon Bedrock", "serviceId" => "Bedrock", "signatureVersion" => "v4", @@ -1066,6 +1137,18 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) end) + api.add_operation(:create_model_copy_job, Seahorse::Model::Operation.new.tap do |o| + o.name = "CreateModelCopyJob" + o.http_method = "POST" + o.http_request_uri = "/model-copy-jobs" + o.input = Shapes::ShapeRef.new(shape: CreateModelCopyJobRequest) + o.output = Shapes::ShapeRef.new(shape: CreateModelCopyJobResponse) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: TooManyTagsException) + end) + api.add_operation(:create_model_customization_job, Seahorse::Model::Operation.new.tap do |o| o.name = "CreateModelCustomizationJob" o.http_method = "POST" @@ -1202,6 +1285,19 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) end) + api.add_operation(:get_model_copy_job, Seahorse::Model::Operation.new.tap do |o| + o.name = "GetModelCopyJob" + o.http_method = "GET" + o.http_request_uri = "/model-copy-jobs/{jobArn}" + o.input = Shapes::ShapeRef.new(shape: GetModelCopyJobRequest) + o.output = Shapes::ShapeRef.new(shape: GetModelCopyJobResponse) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + api.add_operation(:get_model_customization_job, Seahorse::Model::Operation.new.tap do |o| o.name = "GetModelCustomizationJob" o.http_method = "GET" @@ -1306,6 +1402,25 @@ module ClientApi ) end) + api.add_operation(:list_model_copy_jobs, Seahorse::Model::Operation.new.tap do |o| + o.name = "ListModelCopyJobs" + o.http_method = "GET" + o.http_request_uri = "/model-copy-jobs" + o.input = Shapes::ShapeRef.new(shape: ListModelCopyJobsRequest) + o.output = Shapes::ShapeRef.new(shape: ListModelCopyJobsResponse) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o[:pager] = Aws::Pager.new( + limit_key: "max_results", + tokens: { + "next_token" => "next_token" + } + ) + end) + api.add_operation(:list_model_customization_jobs, Seahorse::Model::Operation.new.tap do |o| o.name = "ListModelCustomizationJobs" o.http_method = "GET" diff --git a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/endpoints.rb b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/endpoints.rb index b926eada181..7b0a787dff5 100644 --- a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/endpoints.rb +++ b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/endpoints.rb @@ -54,6 +54,20 @@ def self.build(context) end end + class CreateModelCopyJob + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::Bedrock::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + class CreateModelCustomizationJob def self.build(context) unless context.config.regional_endpoint @@ -194,6 +208,20 @@ def self.build(context) end end + class GetModelCopyJob + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::Bedrock::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + class GetModelCustomizationJob def self.build(context) unless context.config.regional_endpoint @@ -292,6 +320,20 @@ def self.build(context) end end + class ListModelCopyJobs + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::Bedrock::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + class ListModelCustomizationJobs def self.build(context) unless context.config.regional_endpoint diff --git a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/plugins/endpoints.rb b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/plugins/endpoints.rb index af12796192a..62fa11a5f05 100644 --- a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/plugins/endpoints.rb +++ b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/plugins/endpoints.rb @@ -64,6 +64,8 @@ def parameters_for_operation(context) Aws::Bedrock::Endpoints::CreateGuardrail.build(context) when :create_guardrail_version Aws::Bedrock::Endpoints::CreateGuardrailVersion.build(context) + when :create_model_copy_job + Aws::Bedrock::Endpoints::CreateModelCopyJob.build(context) when :create_model_customization_job Aws::Bedrock::Endpoints::CreateModelCustomizationJob.build(context) when :create_provisioned_model_throughput @@ -84,6 +86,8 @@ def parameters_for_operation(context) Aws::Bedrock::Endpoints::GetFoundationModel.build(context) when :get_guardrail Aws::Bedrock::Endpoints::GetGuardrail.build(context) + when :get_model_copy_job + Aws::Bedrock::Endpoints::GetModelCopyJob.build(context) when :get_model_customization_job Aws::Bedrock::Endpoints::GetModelCustomizationJob.build(context) when :get_model_invocation_logging_configuration @@ -98,6 +102,8 @@ def parameters_for_operation(context) Aws::Bedrock::Endpoints::ListFoundationModels.build(context) when :list_guardrails Aws::Bedrock::Endpoints::ListGuardrails.build(context) + when :list_model_copy_jobs + Aws::Bedrock::Endpoints::ListModelCopyJobs.build(context) when :list_model_customization_jobs Aws::Bedrock::Endpoints::ListModelCustomizationJobs.build(context) when :list_provisioned_model_throughputs diff --git a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/types.rb b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/types.rb index edf79ed41ac..af86d309cb9 100644 --- a/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/types.rb +++ b/gems/aws-sdk-bedrock/lib/aws-sdk-bedrock/types.rb @@ -325,6 +325,66 @@ class CreateGuardrailVersionResponse < Struct.new( include Aws::Structure end + # @!attribute [rw] source_model_arn + # The Amazon Resource Name (ARN) of the model to be copied. + # @return [String] + # + # @!attribute [rw] target_model_name + # A name for the copied model. + # @return [String] + # + # @!attribute [rw] model_kms_key_id + # The ARN of the KMS key that you use to encrypt the model copy. + # @return [String] + # + # @!attribute [rw] target_model_tags + # Tags to associate with the target model. For more information, see + # [Tag resources][1] in the [Amazon Bedrock User Guide][2]. + # + # + # + # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html + # @return [Array] + # + # @!attribute [rw] client_request_token + # A unique, case-sensitive identifier to ensure that the API request + # completes no more than one time. If this token matches a previous + # request, Amazon Bedrock ignores the request, but does not return an + # error. For more information, see [Ensuring idempotency][1]. + # + # **A suitable default value is auto-generated.** You should normally + # not need to pass this option. + # + # + # + # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/CreateModelCopyJobRequest AWS API Documentation + # + class CreateModelCopyJobRequest < Struct.new( + :source_model_arn, + :target_model_name, + :model_kms_key_id, + :target_model_tags, + :client_request_token) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] job_arn + # The Amazon Resource Name (ARN) of the model copy job. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/CreateModelCopyJobResponse AWS API Documentation + # + class CreateModelCopyJobResponse < Struct.new( + :job_arn) + SENSITIVE = [] + include Aws::Structure + end + # @!attribute [rw] job_name # A name for the fine-tuning job. # @return [String] @@ -461,7 +521,7 @@ class CreateModelCustomizationJobResponse < Struct.new( # Services support center][1] to request MUs. # # For model unit quotas, see [Provisioned Throughput quotas][2] in the - # Amazon Bedrock User Guide. + # [Amazon Bedrock User Guide][3]. # # For more information about what an MU specifies, contact your Amazon # Web Services account manager. @@ -470,6 +530,7 @@ class CreateModelCustomizationJobResponse < Struct.new( # # [1]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/quotas.html#prov-thru-quotas + # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # @return [Integer] # # @!attribute [rw] provisioned_model_name @@ -480,12 +541,13 @@ class CreateModelCustomizationJobResponse < Struct.new( # The Amazon Resource Name (ARN) or name of the model to associate # with this Provisioned Throughput. For a list of models for which you # can purchase Provisioned Throughput, see [Amazon Bedrock model IDs - # for purchasing Provisioned Throughput][1] in the Amazon Bedrock User - # Guide. + # for purchasing Provisioned Throughput][1] in the [Amazon Bedrock + # User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#prov-throughput-models + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # @return [String] # # @!attribute [rw] commitment_duration @@ -495,11 +557,12 @@ class CreateModelCustomizationJobResponse < Struct.new( # # Custom models support all levels of commitment. To see which base # models support no commitment, see [Supported regions and models for - # Provisioned Throughput][1] in the Amazon Bedrock User Guide + # Provisioned Throughput][1] in the [Amazon Bedrock User Guide][2] # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/pt-supported.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # @return [String] # # @!attribute [rw] tags @@ -563,6 +626,10 @@ class CreateProvisionedModelThroughputResponse < Struct.new( # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html # @return [String] # + # @!attribute [rw] owner_account_id + # The unique identifier of the account that owns the model. + # @return [String] + # # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/CustomModelSummary AWS API Documentation # class CustomModelSummary < Struct.new( @@ -571,7 +638,8 @@ class CustomModelSummary < Struct.new( :creation_time, :base_model_arn, :base_model_name, - :customization_type) + :customization_type, + :owner_account_id) SENSITIVE = [] include Aws::Structure end @@ -1358,6 +1426,82 @@ class GetGuardrailResponse < Struct.new( include Aws::Structure end + # @!attribute [rw] job_arn + # The Amazon Resource Name (ARN) of the model copy job. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GetModelCopyJobRequest AWS API Documentation + # + class GetModelCopyJobRequest < Struct.new( + :job_arn) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] job_arn + # The Amazon Resource Name (ARN) of the model copy job. + # @return [String] + # + # @!attribute [rw] status + # The status of the model copy job. + # @return [String] + # + # @!attribute [rw] creation_time + # The time at which the model copy job was created. + # @return [Time] + # + # @!attribute [rw] target_model_arn + # The Amazon Resource Name (ARN) of the copied model. + # @return [String] + # + # @!attribute [rw] target_model_name + # The name of the copied model. + # @return [String] + # + # @!attribute [rw] source_account_id + # The unique identifier of the account that the model being copied + # originated from. + # @return [String] + # + # @!attribute [rw] source_model_arn + # The Amazon Resource Name (ARN) of the original model being copied. + # @return [String] + # + # @!attribute [rw] target_model_kms_key_arn + # The Amazon Resource Name (ARN) of the KMS key encrypting the copied + # model. + # @return [String] + # + # @!attribute [rw] target_model_tags + # The tags associated with the copied model. + # @return [Array] + # + # @!attribute [rw] failure_message + # An error message for why the model copy job failed. + # @return [String] + # + # @!attribute [rw] source_model_name + # The name of the original model being copied. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GetModelCopyJobResponse AWS API Documentation + # + class GetModelCopyJobResponse < Struct.new( + :job_arn, + :status, + :creation_time, + :target_model_arn, + :target_model_name, + :source_account_id, + :source_model_arn, + :target_model_kms_key_arn, + :target_model_tags, + :failure_message, + :source_model_name) + SENSITIVE = [] + include Aws::Structure + end + # @!attribute [rw] job_identifier # Identifier for the customization job. # @return [String] @@ -1891,7 +2035,7 @@ class GuardrailManagedWordsConfig < Struct.new( # The PII entity configured for the guardrail. # # @!attribute [rw] type - # The type of PII entity. For example, Social Security Number. + # The type of PII entity. For exampvle, Social Security Number. # @return [String] # # @!attribute [rw] action @@ -2619,12 +2763,17 @@ class InternalServerException < Struct.new( # @return [String] # # @!attribute [rw] max_results - # Maximum number of results to return in the response. + # The maximum number of results to return in the response. If the + # total number of results is greater than this value, use the token + # returned in the response in the `nextToken` field when making + # another request to return the next batch of results. # @return [Integer] # # @!attribute [rw] next_token - # Continuation token from the previous response, for Amazon Bedrock to - # list the next set of results. + # If the total number of results is greater than the `maxResults` + # value provided in the request, enter the token returned in the + # `nextToken` field in the response in this field to return the next + # batch of results. # @return [String] # # @!attribute [rw] sort_by @@ -2635,6 +2784,11 @@ class InternalServerException < Struct.new( # The sort order of the results. # @return [String] # + # @!attribute [rw] is_owned + # Return custom models depending on if the current account owns them + # (`true`) or if they were shared with the current account (`false`). + # @return [Boolean] + # # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/ListCustomModelsRequest AWS API Documentation # class ListCustomModelsRequest < Struct.new( @@ -2646,13 +2800,16 @@ class ListCustomModelsRequest < Struct.new( :max_results, :next_token, :sort_by, - :sort_order) + :sort_order, + :is_owned) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] next_token - # Continuation token for the next request to list the next set of + # If the total number of results is greater than the `maxResults` + # value provided in the request, use this token when making another + # request in the `nextToken` field to return the next batch of # results. # @return [String] # @@ -2743,12 +2900,13 @@ class ListEvaluationJobsResponse < Struct.new( # # @!attribute [rw] by_customization_type # Return models that support the customization type that you specify. - # For more information, see [Custom models][1] in the Amazon Bedrock - # User Guide. + # For more information, see [Custom models][1] in the [Amazon Bedrock + # User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/custom-models.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # @return [String] # # @!attribute [rw] by_output_modality @@ -2757,12 +2915,13 @@ class ListEvaluationJobsResponse < Struct.new( # # @!attribute [rw] by_inference_type # Return models that support the inference type that you specify. For - # more information, see [Provisioned Throughput][1] in the Amazon - # Bedrock User Guide. + # more information, see [Provisioned Throughput][1] in the [Amazon + # Bedrock User Guide][2]. # # # # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html + # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/ListFoundationModelsRequest AWS API Documentation @@ -2832,6 +2991,94 @@ class ListGuardrailsResponse < Struct.new( include Aws::Structure end + # @!attribute [rw] creation_time_after + # Filters for model copy jobs created after the specified time. + # @return [Time] + # + # @!attribute [rw] creation_time_before + # Filters for model copy jobs created before the specified time. + # @return [Time] + # + # @!attribute [rw] status_equals + # Filters for model copy jobs whose status matches the value that you + # specify. + # @return [String] + # + # @!attribute [rw] source_account_equals + # Filters for model copy jobs in which the account that the source + # model belongs to is equal to the value that you specify. + # @return [String] + # + # @!attribute [rw] source_model_arn_equals + # Filters for model copy jobs in which the Amazon Resource Name (ARN) + # of the source model to is equal to the value that you specify. + # @return [String] + # + # @!attribute [rw] target_model_name_contains + # Filters for model copy jobs in which the name of the copied model + # contains the string that you specify. + # @return [String] + # + # @!attribute [rw] max_results + # The maximum number of results to return in the response. If the + # total number of results is greater than this value, use the token + # returned in the response in the `nextToken` field when making + # another request to return the next batch of results. + # @return [Integer] + # + # @!attribute [rw] next_token + # If the total number of results is greater than the `maxResults` + # value provided in the request, enter the token returned in the + # `nextToken` field in the response in this field to return the next + # batch of results. + # @return [String] + # + # @!attribute [rw] sort_by + # The field to sort by in the returned list of model copy jobs. + # @return [String] + # + # @!attribute [rw] sort_order + # Specifies whether to sort the results in ascending or descending + # order. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/ListModelCopyJobsRequest AWS API Documentation + # + class ListModelCopyJobsRequest < Struct.new( + :creation_time_after, + :creation_time_before, + :status_equals, + :source_account_equals, + :source_model_arn_equals, + :target_model_name_contains, + :max_results, + :next_token, + :sort_by, + :sort_order) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] next_token + # If the total number of results is greater than the `maxResults` + # value provided in the request, use this token when making another + # request in the `nextToken` field to return the next batch of + # results. + # @return [String] + # + # @!attribute [rw] model_copy_job_summaries + # A list of information about each model copy job. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/ListModelCopyJobsResponse AWS API Documentation + # + class ListModelCopyJobsResponse < Struct.new( + :next_token, + :model_copy_job_summaries) + SENSITIVE = [] + include Aws::Structure + end + # @!attribute [rw] creation_time_after # Return customization jobs created after the specified time. # @return [Time] @@ -2850,12 +3097,17 @@ class ListGuardrailsResponse < Struct.new( # @return [String] # # @!attribute [rw] max_results - # Maximum number of results to return in the response. + # The maximum number of results to return in the response. If the + # total number of results is greater than this value, use the token + # returned in the response in the `nextToken` field when making + # another request to return the next batch of results. # @return [Integer] # # @!attribute [rw] next_token - # Continuation token from the previous response, for Amazon Bedrock to - # list the next set of results. + # If the total number of results is greater than the `maxResults` + # value provided in the request, enter the token returned in the + # `nextToken` field in the response in this field to return the next + # batch of results. # @return [String] # # @!attribute [rw] sort_by @@ -2882,7 +3134,10 @@ class ListModelCustomizationJobsRequest < Struct.new( end # @!attribute [rw] next_token - # Page continuation token to use in the next request. + # If the total number of results is greater than the `maxResults` + # value provided in the request, use this token when making another + # request in the `nextToken` field to return the next batch of + # results. # @return [String] # # @!attribute [rw] model_customization_job_summaries @@ -3041,6 +3296,83 @@ class LoggingConfig < Struct.new( include Aws::Structure end + # Contains details about each model copy job. + # + # This data type is used in the following API operations: + # + # * [ListModelCopyJobs response][1] + # + # ^ + # + # + # + # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListModelCopyJobs.html#API_ListModelCopyJobs_ResponseSyntax + # + # @!attribute [rw] job_arn + # The Amazon Resoource Name (ARN) of the model copy job. + # @return [String] + # + # @!attribute [rw] status + # The status of the model copy job. + # @return [String] + # + # @!attribute [rw] creation_time + # The time that the model copy job was created. + # @return [Time] + # + # @!attribute [rw] target_model_arn + # The Amazon Resource Name (ARN) of the copied model. + # @return [String] + # + # @!attribute [rw] target_model_name + # The name of the copied model. + # @return [String] + # + # @!attribute [rw] source_account_id + # The unique identifier of the account that the model being copied + # originated from. + # @return [String] + # + # @!attribute [rw] source_model_arn + # The Amazon Resource Name (ARN) of the original model being copied. + # @return [String] + # + # @!attribute [rw] target_model_kms_key_arn + # The Amazon Resource Name (ARN) of the KMS key used to encrypt the + # copied model. + # @return [String] + # + # @!attribute [rw] target_model_tags + # Tags associated with the copied model. + # @return [Array] + # + # @!attribute [rw] failure_message + # If a model fails to be copied, a message describing why the job + # failed is included here. + # @return [String] + # + # @!attribute [rw] source_model_name + # The name of the original model being copied. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/ModelCopyJobSummary AWS API Documentation + # + class ModelCopyJobSummary < Struct.new( + :job_arn, + :status, + :creation_time, + :target_model_arn, + :target_model_name, + :source_account_id, + :source_model_arn, + :target_model_kms_key_arn, + :target_model_tags, + :failure_message, + :source_model_name) + SENSITIVE = [] + include Aws::Structure + end + # Information about one customization job # # @!attribute [rw] job_arn diff --git a/gems/aws-sdk-bedrock/sig/client.rbs b/gems/aws-sdk-bedrock/sig/client.rbs index dc8b4edd994..5d6b7caad9e 100644 --- a/gems/aws-sdk-bedrock/sig/client.rbs +++ b/gems/aws-sdk-bedrock/sig/client.rbs @@ -239,6 +239,25 @@ module Aws ) -> _CreateGuardrailVersionResponseSuccess | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateGuardrailVersionResponseSuccess + interface _CreateModelCopyJobResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::CreateModelCopyJobResponse] + def job_arn: () -> ::String + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Bedrock/Client.html#create_model_copy_job-instance_method + def create_model_copy_job: ( + source_model_arn: ::String, + target_model_name: ::String, + ?model_kms_key_id: ::String, + ?target_model_tags: Array[ + { + key: ::String, + value: ::String + }, + ], + ?client_request_token: ::String + ) -> _CreateModelCopyJobResponseSuccess + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateModelCopyJobResponseSuccess + interface _CreateModelCustomizationJobResponseSuccess include ::Seahorse::Client::_ResponseSuccess[Types::CreateModelCustomizationJobResponse] def job_arn: () -> ::String @@ -424,6 +443,26 @@ module Aws ) -> _GetGuardrailResponseSuccess | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetGuardrailResponseSuccess + interface _GetModelCopyJobResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::GetModelCopyJobResponse] + def job_arn: () -> ::String + def status: () -> ("InProgress" | "Completed" | "Failed") + def creation_time: () -> ::Time + def target_model_arn: () -> ::String + def target_model_name: () -> ::String + def source_account_id: () -> ::String + def source_model_arn: () -> ::String + def target_model_kms_key_arn: () -> ::String + def target_model_tags: () -> ::Array[Types::Tag] + def failure_message: () -> ::String + def source_model_name: () -> ::String + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Bedrock/Client.html#get_model_copy_job-instance_method + def get_model_copy_job: ( + job_arn: ::String + ) -> _GetModelCopyJobResponseSuccess + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetModelCopyJobResponseSuccess + interface _GetModelCustomizationJobResponseSuccess include ::Seahorse::Client::_ResponseSuccess[Types::GetModelCustomizationJobResponse] def job_arn: () -> ::String @@ -500,7 +539,8 @@ module Aws ?max_results: ::Integer, ?next_token: ::String, ?sort_by: ("CreationTime"), - ?sort_order: ("Ascending" | "Descending") + ?sort_order: ("Ascending" | "Descending"), + ?is_owned: bool ) -> _ListCustomModelsResponseSuccess | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListCustomModelsResponseSuccess @@ -548,6 +588,26 @@ module Aws ) -> _ListGuardrailsResponseSuccess | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListGuardrailsResponseSuccess + interface _ListModelCopyJobsResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::ListModelCopyJobsResponse] + def next_token: () -> ::String + def model_copy_job_summaries: () -> ::Array[Types::ModelCopyJobSummary] + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Bedrock/Client.html#list_model_copy_jobs-instance_method + def list_model_copy_jobs: ( + ?creation_time_after: ::Time, + ?creation_time_before: ::Time, + ?status_equals: ("InProgress" | "Completed" | "Failed"), + ?source_account_equals: ::String, + ?source_model_arn_equals: ::String, + ?target_model_name_contains: ::String, + ?max_results: ::Integer, + ?next_token: ::String, + ?sort_by: ("CreationTime"), + ?sort_order: ("Ascending" | "Descending") + ) -> _ListModelCopyJobsResponseSuccess + | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListModelCopyJobsResponseSuccess + interface _ListModelCustomizationJobsResponseSuccess include ::Seahorse::Client::_ResponseSuccess[Types::ListModelCustomizationJobsResponse] def next_token: () -> ::String diff --git a/gems/aws-sdk-bedrock/sig/types.rbs b/gems/aws-sdk-bedrock/sig/types.rbs index e43695faad1..cd91a50364a 100644 --- a/gems/aws-sdk-bedrock/sig/types.rbs +++ b/gems/aws-sdk-bedrock/sig/types.rbs @@ -85,6 +85,20 @@ module Aws::Bedrock SENSITIVE: [] end + class CreateModelCopyJobRequest + attr_accessor source_model_arn: ::String + attr_accessor target_model_name: ::String + attr_accessor model_kms_key_id: ::String + attr_accessor target_model_tags: ::Array[Types::Tag] + attr_accessor client_request_token: ::String + SENSITIVE: [] + end + + class CreateModelCopyJobResponse + attr_accessor job_arn: ::String + SENSITIVE: [] + end + class CreateModelCustomizationJobRequest attr_accessor job_name: ::String attr_accessor custom_model_name: ::String @@ -130,6 +144,7 @@ module Aws::Bedrock attr_accessor base_model_arn: ::String attr_accessor base_model_name: ::String attr_accessor customization_type: ("FINE_TUNING" | "CONTINUED_PRE_TRAINING") + attr_accessor owner_account_id: ::String SENSITIVE: [] end @@ -362,6 +377,26 @@ module Aws::Bedrock SENSITIVE: [:name, :description, :blocked_input_messaging, :blocked_outputs_messaging] end + class GetModelCopyJobRequest + attr_accessor job_arn: ::String + SENSITIVE: [] + end + + class GetModelCopyJobResponse + attr_accessor job_arn: ::String + attr_accessor status: ("InProgress" | "Completed" | "Failed") + attr_accessor creation_time: ::Time + attr_accessor target_model_arn: ::String + attr_accessor target_model_name: ::String + attr_accessor source_account_id: ::String + attr_accessor source_model_arn: ::String + attr_accessor target_model_kms_key_arn: ::String + attr_accessor target_model_tags: ::Array[Types::Tag] + attr_accessor failure_message: ::String + attr_accessor source_model_name: ::String + SENSITIVE: [] + end + class GetModelCustomizationJobRequest attr_accessor job_identifier: ::String SENSITIVE: [] @@ -613,6 +648,7 @@ module Aws::Bedrock attr_accessor next_token: ::String attr_accessor sort_by: ("CreationTime") attr_accessor sort_order: ("Ascending" | "Descending") + attr_accessor is_owned: bool SENSITIVE: [] end @@ -666,6 +702,26 @@ module Aws::Bedrock SENSITIVE: [] end + class ListModelCopyJobsRequest + attr_accessor creation_time_after: ::Time + attr_accessor creation_time_before: ::Time + attr_accessor status_equals: ("InProgress" | "Completed" | "Failed") + attr_accessor source_account_equals: ::String + attr_accessor source_model_arn_equals: ::String + attr_accessor target_model_name_contains: ::String + attr_accessor max_results: ::Integer + attr_accessor next_token: ::String + attr_accessor sort_by: ("CreationTime") + attr_accessor sort_order: ("Ascending" | "Descending") + SENSITIVE: [] + end + + class ListModelCopyJobsResponse + attr_accessor next_token: ::String + attr_accessor model_copy_job_summaries: ::Array[Types::ModelCopyJobSummary] + SENSITIVE: [] + end + class ListModelCustomizationJobsRequest attr_accessor creation_time_after: ::Time attr_accessor creation_time_before: ::Time @@ -722,6 +778,21 @@ module Aws::Bedrock SENSITIVE: [] end + class ModelCopyJobSummary + attr_accessor job_arn: ::String + attr_accessor status: ("InProgress" | "Completed" | "Failed") + attr_accessor creation_time: ::Time + attr_accessor target_model_arn: ::String + attr_accessor target_model_name: ::String + attr_accessor source_account_id: ::String + attr_accessor source_model_arn: ::String + attr_accessor target_model_kms_key_arn: ::String + attr_accessor target_model_tags: ::Array[Types::Tag] + attr_accessor failure_message: ::String + attr_accessor source_model_name: ::String + SENSITIVE: [] + end + class ModelCustomizationJobSummary attr_accessor job_arn: ::String attr_accessor base_model_arn: ::String diff --git a/gems/aws-sdk-controlcatalog/CHANGELOG.md b/gems/aws-sdk-controlcatalog/CHANGELOG.md index dfa88f42791..65b0ad1b598 100644 --- a/gems/aws-sdk-controlcatalog/CHANGELOG.md +++ b/gems/aws-sdk-controlcatalog/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.7.0 (2024-08-01) +------------------ + +* Feature - AWS Control Tower provides two new public APIs controlcatalog:ListControls and controlcatalog:GetControl under controlcatalog service namespace, which enable customers to programmatically retrieve control metadata of available controls. + 1.6.0 (2024-07-02) ------------------ diff --git a/gems/aws-sdk-controlcatalog/VERSION b/gems/aws-sdk-controlcatalog/VERSION index dc1e644a101..bd8bf882d06 100644 --- a/gems/aws-sdk-controlcatalog/VERSION +++ b/gems/aws-sdk-controlcatalog/VERSION @@ -1 +1 @@ -1.6.0 +1.7.0 diff --git a/gems/aws-sdk-controlcatalog/aws-sdk-controlcatalog.gemspec b/gems/aws-sdk-controlcatalog/aws-sdk-controlcatalog.gemspec index 57a73da419a..63a774064e9 100644 --- a/gems/aws-sdk-controlcatalog/aws-sdk-controlcatalog.gemspec +++ b/gems/aws-sdk-controlcatalog/aws-sdk-controlcatalog.gemspec @@ -26,7 +26,7 @@ Gem::Specification.new do |spec| } spec.add_dependency('aws-sdk-core', '~> 3', '>= 3.201.0') - spec.add_dependency('aws-sigv4', '~> 1.1') + spec.add_dependency('aws-sigv4', '~> 1.5') spec.required_ruby_version = '>= 2.5' end diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog.rb index b69e80d2521..f8dde65f97a 100644 --- a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog.rb +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog.rb @@ -16,6 +16,7 @@ require_relative 'aws-sdk-controlcatalog/plugins/endpoints.rb' require_relative 'aws-sdk-controlcatalog/client' require_relative 'aws-sdk-controlcatalog/errors' +require_relative 'aws-sdk-controlcatalog/waiters' require_relative 'aws-sdk-controlcatalog/resource' require_relative 'aws-sdk-controlcatalog/endpoint_parameters' require_relative 'aws-sdk-controlcatalog/endpoint_provider' @@ -32,7 +33,7 @@ # structure. # # control_catalog = Aws::ControlCatalog::Client.new -# resp = control_catalog.list_common_controls(params) +# resp = control_catalog.get_control(params) # # See {Client} for more information. # @@ -52,6 +53,6 @@ # @!group service module Aws::ControlCatalog - GEM_VERSION = '1.6.0' + GEM_VERSION = '1.7.0' end diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client.rb index 0a9e43a8f0a..12468c3b9bc 100644 --- a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client.rb +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client.rb @@ -425,6 +425,68 @@ def initialize(*args) # @!group API Operations + # Returns details about a specific control, most notably a list of + # Amazon Web Services Regions where this control is supported. Input a + # value for the *ControlArn* parameter, in ARN form. `GetControl` + # accepts *controltower* or *controlcatalog* control ARNs as input. + # Returns a *controlcatalog* ARN format. + # + # In the API response, controls that have the value `GLOBAL` in the + # `Scope` field do not show the `DeployableRegions` field, because it + # does not apply. Controls that have the value `REGIONAL` in the `Scope` + # field return a value for the `DeployableRegions` field, as shown in + # the example. + # + # @option params [required, String] :control_arn + # The Amazon Resource Name (ARN) of the control. It has one of the + # following formats: + # + # *Global format* + # + # `arn:\{PARTITION\}:controlcatalog:::control/\{CONTROL_CATALOG_OPAQUE_ID\}` + # + # *Or Regional format* + # + # `arn:\{PARTITION\}:controltower:\{REGION\}::control/\{CONTROL_TOWER_OPAQUE_ID\}` + # + # Here is a more general pattern that covers Amazon Web Services Control + # Tower and Control Catalog ARNs: + # + # `^arn:(aws(?:[-a-z]*)?):(controlcatalog|controltower):[a-zA-Z0-9-]*::control/[0-9a-zA-Z_\\-]+$` + # + # @return [Types::GetControlResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::GetControlResponse#arn #arn} => String + # * {Types::GetControlResponse#name #name} => String + # * {Types::GetControlResponse#description #description} => String + # * {Types::GetControlResponse#behavior #behavior} => String + # * {Types::GetControlResponse#region_configuration #region_configuration} => Types::RegionConfiguration + # + # @example Request syntax with placeholder values + # + # resp = client.get_control({ + # control_arn: "ControlArn", # required + # }) + # + # @example Response structure + # + # resp.arn #=> String + # resp.name #=> String + # resp.description #=> String + # resp.behavior #=> String, one of "PREVENTIVE", "PROACTIVE", "DETECTIVE" + # resp.region_configuration.scope #=> String, one of "GLOBAL", "REGIONAL" + # resp.region_configuration.deployable_regions #=> Array + # resp.region_configuration.deployable_regions[0] #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/GetControl AWS API Documentation + # + # @overload get_control(params = {}) + # @param [Hash] params ({}) + def get_control(params = {}, options = {}) + req = build_request(:get_control, params) + req.send_request(options) + end + # Returns a paginated list of common controls from the Amazon Web # Services Control Catalog. # @@ -432,18 +494,18 @@ def initialize(*args) # specific objective. If you don’t provide a filter, the operation # returns all common controls. # - # @option params [Types::CommonControlFilter] :common_control_filter - # An optional filter that narrows the results to a specific objective. - # - # This filter allows you to specify one objective ARN at a time. Passing - # multiple ARNs in the `CommonControlFilter` isn’t currently supported. - # # @option params [Integer] :max_results # The maximum number of results on a page or for an API request call. # # @option params [String] :next_token # The pagination token that's used to fetch the next set of results. # + # @option params [Types::CommonControlFilter] :common_control_filter + # An optional filter that narrows the results to a specific objective. + # + # This filter allows you to specify one objective ARN at a time. Passing + # multiple ARNs in the `CommonControlFilter` isn’t currently supported. + # # @return [Types::ListCommonControlsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::ListCommonControlsResponse#common_controls #common_controls} => Array<Types::CommonControlSummary> @@ -454,6 +516,8 @@ def initialize(*args) # @example Request syntax with placeholder values # # resp = client.list_common_controls({ + # max_results: 1, + # next_token: "PaginationToken", # common_control_filter: { # objectives: [ # { @@ -461,22 +525,20 @@ def initialize(*args) # }, # ], # }, - # max_results: 1, - # next_token: "PaginationToken", # }) # # @example Response structure # # resp.common_controls #=> Array # resp.common_controls[0].arn #=> String - # resp.common_controls[0].create_time #=> Time + # resp.common_controls[0].name #=> String # resp.common_controls[0].description #=> String # resp.common_controls[0].domain.arn #=> String # resp.common_controls[0].domain.name #=> String - # resp.common_controls[0].last_update_time #=> Time - # resp.common_controls[0].name #=> String # resp.common_controls[0].objective.arn #=> String # resp.common_controls[0].objective.name #=> String + # resp.common_controls[0].create_time #=> Time + # resp.common_controls[0].last_update_time #=> Time # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListCommonControls AWS API Documentation @@ -488,6 +550,49 @@ def list_common_controls(params = {}, options = {}) req.send_request(options) end + # Returns a paginated list of all available controls in the Amazon Web + # Services Control Catalog library. Allows you to discover available + # controls. The list of controls is given as structures of type + # *controlSummary*. The ARN is returned in the global *controlcatalog* + # format, as shown in the examples. + # + # @option params [String] :next_token + # The pagination token that's used to fetch the next set of results. + # + # @option params [Integer] :max_results + # The maximum number of results on a page or for an API request call. + # + # @return [Types::ListControlsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::ListControlsResponse#controls #controls} => Array<Types::ControlSummary> + # * {Types::ListControlsResponse#next_token #next_token} => String + # + # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. + # + # @example Request syntax with placeholder values + # + # resp = client.list_controls({ + # next_token: "PaginationToken", + # max_results: 1, + # }) + # + # @example Response structure + # + # resp.controls #=> Array + # resp.controls[0].arn #=> String + # resp.controls[0].name #=> String + # resp.controls[0].description #=> String + # resp.next_token #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListControls AWS API Documentation + # + # @overload list_controls(params = {}) + # @param [Hash] params ({}) + def list_controls(params = {}, options = {}) + req = build_request(:list_controls, params) + req.send_request(options) + end + # Returns a paginated list of domains from the Amazon Web Services # Control Catalog. # @@ -515,10 +620,10 @@ def list_common_controls(params = {}, options = {}) # # resp.domains #=> Array # resp.domains[0].arn #=> String - # resp.domains[0].create_time #=> Time + # resp.domains[0].name #=> String # resp.domains[0].description #=> String + # resp.domains[0].create_time #=> Time # resp.domains[0].last_update_time #=> Time - # resp.domains[0].name #=> String # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListDomains AWS API Documentation @@ -551,8 +656,8 @@ def list_domains(params = {}, options = {}) # # @return [Types::ListObjectivesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # - # * {Types::ListObjectivesResponse#next_token #next_token} => String # * {Types::ListObjectivesResponse#objectives #objectives} => Array<Types::ObjectiveSummary> + # * {Types::ListObjectivesResponse#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # @@ -572,15 +677,15 @@ def list_domains(params = {}, options = {}) # # @example Response structure # - # resp.next_token #=> String # resp.objectives #=> Array # resp.objectives[0].arn #=> String - # resp.objectives[0].create_time #=> Time + # resp.objectives[0].name #=> String # resp.objectives[0].description #=> String # resp.objectives[0].domain.arn #=> String # resp.objectives[0].domain.name #=> String + # resp.objectives[0].create_time #=> Time # resp.objectives[0].last_update_time #=> Time - # resp.objectives[0].name #=> String + # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListObjectives AWS API Documentation # @@ -604,7 +709,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-controlcatalog' - context[:gem_version] = '1.6.0' + context[:gem_version] = '1.7.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client_api.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client_api.rb index c853acd112a..35efa800d11 100644 --- a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client_api.rb +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/client_api.rb @@ -20,19 +20,30 @@ module ClientApi CommonControlFilter = Shapes::StructureShape.new(name: 'CommonControlFilter') CommonControlSummary = Shapes::StructureShape.new(name: 'CommonControlSummary') CommonControlSummaryList = Shapes::ListShape.new(name: 'CommonControlSummaryList') + ControlArn = Shapes::StringShape.new(name: 'ControlArn') + ControlBehavior = Shapes::StringShape.new(name: 'ControlBehavior') + ControlScope = Shapes::StringShape.new(name: 'ControlScope') + ControlSummary = Shapes::StructureShape.new(name: 'ControlSummary') + Controls = Shapes::ListShape.new(name: 'Controls') + DeployableRegions = Shapes::ListShape.new(name: 'DeployableRegions') DomainArn = Shapes::StringShape.new(name: 'DomainArn') DomainResourceFilter = Shapes::StructureShape.new(name: 'DomainResourceFilter') DomainResourceFilterList = Shapes::ListShape.new(name: 'DomainResourceFilterList') DomainSummary = Shapes::StructureShape.new(name: 'DomainSummary') DomainSummaryList = Shapes::ListShape.new(name: 'DomainSummaryList') + GetControlRequest = Shapes::StructureShape.new(name: 'GetControlRequest') + GetControlResponse = Shapes::StructureShape.new(name: 'GetControlResponse') InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException') ListCommonControlsRequest = Shapes::StructureShape.new(name: 'ListCommonControlsRequest') ListCommonControlsResponse = Shapes::StructureShape.new(name: 'ListCommonControlsResponse') + ListControlsRequest = Shapes::StructureShape.new(name: 'ListControlsRequest') + ListControlsResponse = Shapes::StructureShape.new(name: 'ListControlsResponse') ListDomainsRequest = Shapes::StructureShape.new(name: 'ListDomainsRequest') ListDomainsResponse = Shapes::StructureShape.new(name: 'ListDomainsResponse') ListObjectivesRequest = Shapes::StructureShape.new(name: 'ListObjectivesRequest') ListObjectivesResponse = Shapes::StructureShape.new(name: 'ListObjectivesResponse') MaxListCommonControlsResults = Shapes::IntegerShape.new(name: 'MaxListCommonControlsResults') + MaxListControlsResults = Shapes::IntegerShape.new(name: 'MaxListControlsResults') MaxListDomainsResults = Shapes::IntegerShape.new(name: 'MaxListDomainsResults') MaxListObjectivesResults = Shapes::IntegerShape.new(name: 'MaxListObjectivesResults') ObjectiveArn = Shapes::StringShape.new(name: 'ObjectiveArn') @@ -42,6 +53,9 @@ module ClientApi ObjectiveSummary = Shapes::StructureShape.new(name: 'ObjectiveSummary') ObjectiveSummaryList = Shapes::ListShape.new(name: 'ObjectiveSummaryList') PaginationToken = Shapes::StringShape.new(name: 'PaginationToken') + RegionCode = Shapes::StringShape.new(name: 'RegionCode') + RegionConfiguration = Shapes::StructureShape.new(name: 'RegionConfiguration') + ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException') String = Shapes::StringShape.new(name: 'String') ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException') Timestamp = Shapes::TimestampShape.new(name: 'Timestamp') @@ -62,42 +76,69 @@ module ClientApi CommonControlFilter.struct_class = Types::CommonControlFilter CommonControlSummary.add_member(:arn, Shapes::ShapeRef.new(shape: CommonControlArn, required: true, location_name: "Arn")) - CommonControlSummary.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime")) + CommonControlSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) CommonControlSummary.add_member(:description, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Description")) CommonControlSummary.add_member(:domain, Shapes::ShapeRef.new(shape: AssociatedDomainSummary, required: true, location_name: "Domain")) - CommonControlSummary.add_member(:last_update_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "LastUpdateTime")) - CommonControlSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) CommonControlSummary.add_member(:objective, Shapes::ShapeRef.new(shape: AssociatedObjectiveSummary, required: true, location_name: "Objective")) + CommonControlSummary.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime")) + CommonControlSummary.add_member(:last_update_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "LastUpdateTime")) CommonControlSummary.struct_class = Types::CommonControlSummary CommonControlSummaryList.member = Shapes::ShapeRef.new(shape: CommonControlSummary) + ControlSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ControlArn, required: true, location_name: "Arn")) + ControlSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) + ControlSummary.add_member(:description, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Description")) + ControlSummary.struct_class = Types::ControlSummary + + Controls.member = Shapes::ShapeRef.new(shape: ControlSummary) + + DeployableRegions.member = Shapes::ShapeRef.new(shape: RegionCode) + DomainResourceFilter.add_member(:arn, Shapes::ShapeRef.new(shape: DomainArn, location_name: "Arn")) DomainResourceFilter.struct_class = Types::DomainResourceFilter DomainResourceFilterList.member = Shapes::ShapeRef.new(shape: DomainResourceFilter) DomainSummary.add_member(:arn, Shapes::ShapeRef.new(shape: DomainArn, required: true, location_name: "Arn")) - DomainSummary.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime")) + DomainSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) DomainSummary.add_member(:description, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Description")) + DomainSummary.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime")) DomainSummary.add_member(:last_update_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "LastUpdateTime")) - DomainSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) DomainSummary.struct_class = Types::DomainSummary DomainSummaryList.member = Shapes::ShapeRef.new(shape: DomainSummary) + GetControlRequest.add_member(:control_arn, Shapes::ShapeRef.new(shape: ControlArn, required: true, location_name: "ControlArn")) + GetControlRequest.struct_class = Types::GetControlRequest + + GetControlResponse.add_member(:arn, Shapes::ShapeRef.new(shape: ControlArn, required: true, location_name: "Arn")) + GetControlResponse.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) + GetControlResponse.add_member(:description, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Description")) + GetControlResponse.add_member(:behavior, Shapes::ShapeRef.new(shape: ControlBehavior, required: true, location_name: "Behavior")) + GetControlResponse.add_member(:region_configuration, Shapes::ShapeRef.new(shape: RegionConfiguration, required: true, location_name: "RegionConfiguration")) + GetControlResponse.struct_class = Types::GetControlResponse + InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) InternalServerException.struct_class = Types::InternalServerException - ListCommonControlsRequest.add_member(:common_control_filter, Shapes::ShapeRef.new(shape: CommonControlFilter, location_name: "CommonControlFilter")) ListCommonControlsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxListCommonControlsResults, location: "querystring", location_name: "maxResults")) ListCommonControlsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location: "querystring", location_name: "nextToken")) + ListCommonControlsRequest.add_member(:common_control_filter, Shapes::ShapeRef.new(shape: CommonControlFilter, location_name: "CommonControlFilter")) ListCommonControlsRequest.struct_class = Types::ListCommonControlsRequest ListCommonControlsResponse.add_member(:common_controls, Shapes::ShapeRef.new(shape: CommonControlSummaryList, required: true, location_name: "CommonControls")) ListCommonControlsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken")) ListCommonControlsResponse.struct_class = Types::ListCommonControlsResponse + ListControlsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location: "querystring", location_name: "nextToken")) + ListControlsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxListControlsResults, location: "querystring", location_name: "maxResults")) + ListControlsRequest.struct_class = Types::ListControlsRequest + + ListControlsResponse.add_member(:controls, Shapes::ShapeRef.new(shape: Controls, required: true, location_name: "Controls")) + ListControlsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken")) + ListControlsResponse.struct_class = Types::ListControlsResponse + ListDomainsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxListDomainsResults, location: "querystring", location_name: "maxResults")) ListDomainsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location: "querystring", location_name: "nextToken")) ListDomainsRequest.struct_class = Types::ListDomainsRequest @@ -111,8 +152,8 @@ module ClientApi ListObjectivesRequest.add_member(:objective_filter, Shapes::ShapeRef.new(shape: ObjectiveFilter, location_name: "ObjectiveFilter")) ListObjectivesRequest.struct_class = Types::ListObjectivesRequest - ListObjectivesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken")) ListObjectivesResponse.add_member(:objectives, Shapes::ShapeRef.new(shape: ObjectiveSummaryList, required: true, location_name: "Objectives")) + ListObjectivesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken")) ListObjectivesResponse.struct_class = Types::ListObjectivesResponse ObjectiveFilter.add_member(:domains, Shapes::ShapeRef.new(shape: DomainResourceFilterList, location_name: "Domains")) @@ -124,15 +165,22 @@ module ClientApi ObjectiveResourceFilterList.member = Shapes::ShapeRef.new(shape: ObjectiveResourceFilter) ObjectiveSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ObjectiveArn, required: true, location_name: "Arn")) - ObjectiveSummary.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime")) + ObjectiveSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) ObjectiveSummary.add_member(:description, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Description")) ObjectiveSummary.add_member(:domain, Shapes::ShapeRef.new(shape: AssociatedDomainSummary, required: true, location_name: "Domain")) + ObjectiveSummary.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime")) ObjectiveSummary.add_member(:last_update_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "LastUpdateTime")) - ObjectiveSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name")) ObjectiveSummary.struct_class = Types::ObjectiveSummary ObjectiveSummaryList.member = Shapes::ShapeRef.new(shape: ObjectiveSummary) + RegionConfiguration.add_member(:scope, Shapes::ShapeRef.new(shape: ControlScope, required: true, location_name: "Scope")) + RegionConfiguration.add_member(:deployable_regions, Shapes::ShapeRef.new(shape: DeployableRegions, location_name: "DeployableRegions")) + RegionConfiguration.struct_class = Types::RegionConfiguration + + ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) + ResourceNotFoundException.struct_class = Types::ResourceNotFoundException + ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) ThrottlingException.struct_class = Types::ThrottlingException @@ -147,9 +195,10 @@ module ClientApi api.metadata = { "apiVersion" => "2018-05-10", + "auth" => ["aws.auth#sigv4"], "endpointPrefix" => "controlcatalog", - "jsonVersion" => "1.1", "protocol" => "rest-json", + "protocols" => ["rest-json"], "serviceFullName" => "AWS Control Catalog", "serviceId" => "ControlCatalog", "signatureVersion" => "v4", @@ -157,6 +206,19 @@ module ClientApi "uid" => "controlcatalog-2018-05-10", } + api.add_operation(:get_control, Seahorse::Model::Operation.new.tap do |o| + o.name = "GetControl" + o.http_method = "POST" + o.http_request_uri = "/get-control" + o.input = Shapes::ShapeRef.new(shape: GetControlRequest) + o.output = Shapes::ShapeRef.new(shape: GetControlResponse) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + api.add_operation(:list_common_controls, Seahorse::Model::Operation.new.tap do |o| o.name = "ListCommonControls" o.http_method = "POST" @@ -175,6 +237,24 @@ module ClientApi ) end) + api.add_operation(:list_controls, Seahorse::Model::Operation.new.tap do |o| + o.name = "ListControls" + o.http_method = "POST" + o.http_request_uri = "/list-controls" + o.input = Shapes::ShapeRef.new(shape: ListControlsRequest) + o.output = Shapes::ShapeRef.new(shape: ListControlsResponse) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o[:pager] = Aws::Pager.new( + limit_key: "max_results", + tokens: { + "next_token" => "next_token" + } + ) + end) + api.add_operation(:list_domains, Seahorse::Model::Operation.new.tap do |o| o.name = "ListDomains" o.http_method = "POST" diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/endpoints.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/endpoints.rb index 0e7b33c166e..96846fceaa6 100644 --- a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/endpoints.rb +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/endpoints.rb @@ -12,6 +12,20 @@ module Aws::ControlCatalog # @api private module Endpoints + class GetControl + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::ControlCatalog::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + class ListCommonControls def self.build(context) unless context.config.regional_endpoint @@ -26,6 +40,20 @@ def self.build(context) end end + class ListControls + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::ControlCatalog::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + class ListDomains def self.build(context) unless context.config.regional_endpoint diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/errors.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/errors.rb index f54801b8865..49d7eeeed0b 100644 --- a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/errors.rb +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/errors.rb @@ -29,6 +29,7 @@ module Aws::ControlCatalog # ## Error Classes # * {AccessDeniedException} # * {InternalServerException} + # * {ResourceNotFoundException} # * {ThrottlingException} # * {ValidationException} # @@ -72,6 +73,21 @@ def retryable? end end + class ResourceNotFoundException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::ControlCatalog::Types::ResourceNotFoundException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + end + class ThrottlingException < ServiceError # @param [Seahorse::Client::RequestContext] context diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/plugins/endpoints.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/plugins/endpoints.rb index 62f06dc4046..270707187f7 100644 --- a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/plugins/endpoints.rb +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/plugins/endpoints.rb @@ -58,8 +58,12 @@ def apply_endpoint_headers(context, headers) def parameters_for_operation(context) case context.operation_name + when :get_control + Aws::ControlCatalog::Endpoints::GetControl.build(context) when :list_common_controls Aws::ControlCatalog::Endpoints::ListCommonControls.build(context) + when :list_controls + Aws::ControlCatalog::Endpoints::ListControls.build(context) when :list_domains Aws::ControlCatalog::Endpoints::ListDomains.build(context) when :list_objectives diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb index 8b46dc0af78..7f1cb4d2391 100644 --- a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb @@ -86,9 +86,9 @@ class CommonControlFilter < Struct.new( # The Amazon Resource Name (ARN) that identifies the common control. # @return [String] # - # @!attribute [rw] create_time - # The time when the common control was created. - # @return [Time] + # @!attribute [rw] name + # The name of the common control. + # @return [String] # # @!attribute [rw] description # The description of the common control. @@ -98,28 +98,53 @@ class CommonControlFilter < Struct.new( # The domain that the common control belongs to. # @return [Types::AssociatedDomainSummary] # - # @!attribute [rw] last_update_time - # The time when the common control was most recently updated. - # @return [Time] - # - # @!attribute [rw] name - # The name of the common control. - # @return [String] - # # @!attribute [rw] objective # The objective that the common control belongs to. # @return [Types::AssociatedObjectiveSummary] # + # @!attribute [rw] create_time + # The time when the common control was created. + # @return [Time] + # + # @!attribute [rw] last_update_time + # The time when the common control was most recently updated. + # @return [Time] + # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/CommonControlSummary AWS API Documentation # class CommonControlSummary < Struct.new( :arn, - :create_time, + :name, :description, :domain, - :last_update_time, + :objective, + :create_time, + :last_update_time) + SENSITIVE = [] + include Aws::Structure + end + + # Overview of information about a control. + # + # @!attribute [rw] arn + # The Amazon Resource Name (ARN) of the control. + # @return [String] + # + # @!attribute [rw] name + # The display name of the control. + # @return [String] + # + # @!attribute [rw] description + # A description of the control, as it may appear in the console. + # Describes the functionality of the control. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ControlSummary AWS API Documentation + # + class ControlSummary < Struct.new( + :arn, :name, - :objective) + :description) SENSITIVE = [] include Aws::Structure end @@ -144,30 +169,102 @@ class DomainResourceFilter < Struct.new( # The Amazon Resource Name (ARN) that identifies the domain. # @return [String] # - # @!attribute [rw] create_time - # The time when the domain was created. - # @return [Time] + # @!attribute [rw] name + # The name of the domain. + # @return [String] # # @!attribute [rw] description # The description of the domain. # @return [String] # + # @!attribute [rw] create_time + # The time when the domain was created. + # @return [Time] + # # @!attribute [rw] last_update_time # The time when the domain was most recently updated. # @return [Time] # - # @!attribute [rw] name - # The name of the domain. - # @return [String] - # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/DomainSummary AWS API Documentation # class DomainSummary < Struct.new( :arn, + :name, + :description, :create_time, + :last_update_time) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] control_arn + # The Amazon Resource Name (ARN) of the control. It has one of the + # following formats: + # + # *Global format* + # + # `arn:\{PARTITION\}:controlcatalog:::control/\{CONTROL_CATALOG_OPAQUE_ID\}` + # + # *Or Regional format* + # + # `arn:\{PARTITION\}:controltower:\{REGION\}::control/\{CONTROL_TOWER_OPAQUE_ID\}` + # + # Here is a more general pattern that covers Amazon Web Services + # Control Tower and Control Catalog ARNs: + # + # `^arn:(aws(?:[-a-z]*)?):(controlcatalog|controltower):[a-zA-Z0-9-]*::control/[0-9a-zA-Z_\\-]+$` + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/GetControlRequest AWS API Documentation + # + class GetControlRequest < Struct.new( + :control_arn) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] arn + # The Amazon Resource Name (ARN) of the control. + # @return [String] + # + # @!attribute [rw] name + # The display name of the control. + # @return [String] + # + # @!attribute [rw] description + # A description of what the control does. + # @return [String] + # + # @!attribute [rw] behavior + # A term that identifies the control's functional behavior. One of + # `Preventive`, `Deteictive`, `Proactive` + # @return [String] + # + # @!attribute [rw] region_configuration + # Returns information about the control, including the scope of the + # control, if enabled, and the Regions in which the control currently + # is available for deployment. + # + # If you are applying controls through an Amazon Web Services Control + # Tower landing zone environment, remember that the values returned in + # the `RegionConfiguration` API operation are not related to the + # governed Regions in your landing zone. For example, if you are + # governing Regions `A`,`B`,and `C` while the control is available in + # Regions `A`, `B`, C`,` and `D`, you'd see a response with + # `DeployableRegions` of `A`, `B`, `C`, and `D` for a control with + # `REGIONAL` scope, even though you may not intend to deploy the + # control in Region `D`, because you do not govern it through your + # landing zone. + # @return [Types::RegionConfiguration] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/GetControlResponse AWS API Documentation + # + class GetControlResponse < Struct.new( + :arn, + :name, :description, - :last_update_time, - :name) + :behavior, + :region_configuration) SENSITIVE = [] include Aws::Structure end @@ -186,14 +283,6 @@ class InternalServerException < Struct.new( include Aws::Structure end - # @!attribute [rw] common_control_filter - # An optional filter that narrows the results to a specific objective. - # - # This filter allows you to specify one objective ARN at a time. - # Passing multiple ARNs in the `CommonControlFilter` isn’t currently - # supported. - # @return [Types::CommonControlFilter] - # # @!attribute [rw] max_results # The maximum number of results on a page or for an API request call. # @return [Integer] @@ -202,12 +291,20 @@ class InternalServerException < Struct.new( # The pagination token that's used to fetch the next set of results. # @return [String] # + # @!attribute [rw] common_control_filter + # An optional filter that narrows the results to a specific objective. + # + # This filter allows you to specify one objective ARN at a time. + # Passing multiple ARNs in the `CommonControlFilter` isn’t currently + # supported. + # @return [Types::CommonControlFilter] + # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListCommonControlsRequest AWS API Documentation # class ListCommonControlsRequest < Struct.new( - :common_control_filter, :max_results, - :next_token) + :next_token, + :common_control_filter) SENSITIVE = [] include Aws::Structure end @@ -230,6 +327,41 @@ class ListCommonControlsResponse < Struct.new( include Aws::Structure end + # @!attribute [rw] next_token + # The pagination token that's used to fetch the next set of results. + # @return [String] + # + # @!attribute [rw] max_results + # The maximum number of results on a page or for an API request call. + # @return [Integer] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListControlsRequest AWS API Documentation + # + class ListControlsRequest < Struct.new( + :next_token, + :max_results) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] controls + # Returns a list of controls, given as structures of type + # *controlSummary*. + # @return [Array] + # + # @!attribute [rw] next_token + # The pagination token that's used to fetch the next set of results. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListControlsResponse AWS API Documentation + # + class ListControlsResponse < Struct.new( + :controls, + :next_token) + SENSITIVE = [] + include Aws::Structure + end + # @!attribute [rw] max_results # The maximum number of results on a page or for an API request call. # @return [Integer] @@ -289,19 +421,19 @@ class ListObjectivesRequest < Struct.new( include Aws::Structure end - # @!attribute [rw] next_token - # The pagination token that's used to fetch the next set of results. - # @return [String] - # # @!attribute [rw] objectives # The list of objectives that the `ListObjectives` API returns. # @return [Array] # + # @!attribute [rw] next_token + # The pagination token that's used to fetch the next set of results. + # @return [String] + # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ListObjectivesResponse AWS API Documentation # class ListObjectivesResponse < Struct.new( - :next_token, - :objectives) + :objectives, + :next_token) SENSITIVE = [] include Aws::Structure end @@ -345,9 +477,9 @@ class ObjectiveResourceFilter < Struct.new( # The Amazon Resource Name (ARN) that identifies the objective. # @return [String] # - # @!attribute [rw] create_time - # The time when the objective was created. - # @return [Time] + # @!attribute [rw] name + # The name of the objective. + # @return [String] # # @!attribute [rw] description # The description of the objective. @@ -357,23 +489,76 @@ class ObjectiveResourceFilter < Struct.new( # The domain that the objective belongs to. # @return [Types::AssociatedDomainSummary] # + # @!attribute [rw] create_time + # The time when the objective was created. + # @return [Time] + # # @!attribute [rw] last_update_time # The time when the objective was most recently updated. # @return [Time] # - # @!attribute [rw] name - # The name of the objective. - # @return [String] - # # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ObjectiveSummary AWS API Documentation # class ObjectiveSummary < Struct.new( :arn, - :create_time, + :name, :description, :domain, - :last_update_time, - :name) + :create_time, + :last_update_time) + SENSITIVE = [] + include Aws::Structure + end + + # Returns information about the control, including the scope of the + # control, if enabled, and the Regions in which the control currently is + # available for deployment. + # + # If you are applying controls through an Amazon Web Services Control + # Tower landing zone environment, remember that the values returned in + # the `RegionConfiguration` API operation are not related to the + # governed Regions in your landing zone. For example, if you are + # governing Regions `A`,`B`,and `C` while the control is available in + # Regions `A`, `B`, C`,` and `D`, you'd see a response with + # `DeployableRegions` of `A`, `B`, `C`, and `D` for a control with + # `REGIONAL` scope, even though you may not intend to deploy the control + # in Region `D`, because you do not govern it through your landing zone. + # + # @!attribute [rw] scope + # The coverage of the control, if deployed. Scope is an enumerated + # type, with value `Regional`, or `Global`. A control with Global + # scope is effective in all Amazon Web Services Regions, regardless of + # the Region from which it is enabled, or to which it is deployed. A + # control implemented by an SCP is usually Global in scope. A control + # with Regional scope has operations that are restricted specifically + # to the Region from which it is enabled and to which it is deployed. + # Controls implemented by Config rules and CloudFormation hooks + # usually are Regional in scope. Security Hub controls usually are + # Regional in scope. + # @return [String] + # + # @!attribute [rw] deployable_regions + # Regions in which the control is available to be deployed. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/RegionConfiguration AWS API Documentation + # + class RegionConfiguration < Struct.new( + :scope, + :deployable_regions) + SENSITIVE = [] + include Aws::Structure + end + + # The requested resource does not exist. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/controlcatalog-2018-05-10/ResourceNotFoundException AWS API Documentation + # + class ResourceNotFoundException < Struct.new( + :message) SENSITIVE = [] include Aws::Structure end diff --git a/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/waiters.rb b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/waiters.rb new file mode 100644 index 00000000000..ff2760e49b6 --- /dev/null +++ b/gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/waiters.rb @@ -0,0 +1,15 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +require 'aws-sdk-core/waiters' + +module Aws::ControlCatalog + module Waiters + end +end diff --git a/gems/aws-sdk-controlcatalog/sig/client.rbs b/gems/aws-sdk-controlcatalog/sig/client.rbs index c9aa0b132a6..93ed561295f 100644 --- a/gems/aws-sdk-controlcatalog/sig/client.rbs +++ b/gems/aws-sdk-controlcatalog/sig/client.rbs @@ -73,6 +73,20 @@ module Aws | (?Hash[Symbol, untyped]) -> instance + interface _GetControlResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::GetControlResponse] + def arn: () -> ::String + def name: () -> ::String + def description: () -> ::String + def behavior: () -> ("PREVENTIVE" | "PROACTIVE" | "DETECTIVE") + def region_configuration: () -> Types::RegionConfiguration + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ControlCatalog/Client.html#get_control-instance_method + def get_control: ( + control_arn: ::String + ) -> _GetControlResponseSuccess + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetControlResponseSuccess + interface _ListCommonControlsResponseSuccess include ::Seahorse::Client::_ResponseSuccess[Types::ListCommonControlsResponse] def common_controls: () -> ::Array[Types::CommonControlSummary] @@ -80,18 +94,30 @@ module Aws end # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ControlCatalog/Client.html#list_common_controls-instance_method def list_common_controls: ( + ?max_results: ::Integer, + ?next_token: ::String, ?common_control_filter: { objectives: Array[ { arn: ::String? }, ]? - }, - ?max_results: ::Integer, - ?next_token: ::String + } ) -> _ListCommonControlsResponseSuccess | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListCommonControlsResponseSuccess + interface _ListControlsResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::ListControlsResponse] + def controls: () -> ::Array[Types::ControlSummary] + def next_token: () -> ::String + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ControlCatalog/Client.html#list_controls-instance_method + def list_controls: ( + ?next_token: ::String, + ?max_results: ::Integer + ) -> _ListControlsResponseSuccess + | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListControlsResponseSuccess + interface _ListDomainsResponseSuccess include ::Seahorse::Client::_ResponseSuccess[Types::ListDomainsResponse] def domains: () -> ::Array[Types::DomainSummary] @@ -106,8 +132,8 @@ module Aws interface _ListObjectivesResponseSuccess include ::Seahorse::Client::_ResponseSuccess[Types::ListObjectivesResponse] - def next_token: () -> ::String def objectives: () -> ::Array[Types::ObjectiveSummary] + def next_token: () -> ::String end # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ControlCatalog/Client.html#list_objectives-instance_method def list_objectives: ( diff --git a/gems/aws-sdk-controlcatalog/sig/errors.rbs b/gems/aws-sdk-controlcatalog/sig/errors.rbs index f2886e67534..7d2839e545d 100644 --- a/gems/aws-sdk-controlcatalog/sig/errors.rbs +++ b/gems/aws-sdk-controlcatalog/sig/errors.rbs @@ -17,6 +17,9 @@ module Aws class InternalServerException < ::Aws::Errors::ServiceError def message: () -> ::String end + class ResourceNotFoundException < ::Aws::Errors::ServiceError + def message: () -> ::String + end class ThrottlingException < ::Aws::Errors::ServiceError def message: () -> ::String end diff --git a/gems/aws-sdk-controlcatalog/sig/types.rbs b/gems/aws-sdk-controlcatalog/sig/types.rbs index 54d86c570b1..a0e9220113b 100644 --- a/gems/aws-sdk-controlcatalog/sig/types.rbs +++ b/gems/aws-sdk-controlcatalog/sig/types.rbs @@ -32,12 +32,19 @@ module Aws::ControlCatalog class CommonControlSummary attr_accessor arn: ::String - attr_accessor create_time: ::Time + attr_accessor name: ::String attr_accessor description: ::String attr_accessor domain: Types::AssociatedDomainSummary + attr_accessor objective: Types::AssociatedObjectiveSummary + attr_accessor create_time: ::Time attr_accessor last_update_time: ::Time + SENSITIVE: [] + end + + class ControlSummary + attr_accessor arn: ::String attr_accessor name: ::String - attr_accessor objective: Types::AssociatedObjectiveSummary + attr_accessor description: ::String SENSITIVE: [] end @@ -48,10 +55,24 @@ module Aws::ControlCatalog class DomainSummary attr_accessor arn: ::String - attr_accessor create_time: ::Time + attr_accessor name: ::String attr_accessor description: ::String + attr_accessor create_time: ::Time attr_accessor last_update_time: ::Time + SENSITIVE: [] + end + + class GetControlRequest + attr_accessor control_arn: ::String + SENSITIVE: [] + end + + class GetControlResponse + attr_accessor arn: ::String attr_accessor name: ::String + attr_accessor description: ::String + attr_accessor behavior: ("PREVENTIVE" | "PROACTIVE" | "DETECTIVE") + attr_accessor region_configuration: Types::RegionConfiguration SENSITIVE: [] end @@ -61,9 +82,9 @@ module Aws::ControlCatalog end class ListCommonControlsRequest - attr_accessor common_control_filter: Types::CommonControlFilter attr_accessor max_results: ::Integer attr_accessor next_token: ::String + attr_accessor common_control_filter: Types::CommonControlFilter SENSITIVE: [] end @@ -73,6 +94,18 @@ module Aws::ControlCatalog SENSITIVE: [] end + class ListControlsRequest + attr_accessor next_token: ::String + attr_accessor max_results: ::Integer + SENSITIVE: [] + end + + class ListControlsResponse + attr_accessor controls: ::Array[Types::ControlSummary] + attr_accessor next_token: ::String + SENSITIVE: [] + end + class ListDomainsRequest attr_accessor max_results: ::Integer attr_accessor next_token: ::String @@ -93,8 +126,8 @@ module Aws::ControlCatalog end class ListObjectivesResponse - attr_accessor next_token: ::String attr_accessor objectives: ::Array[Types::ObjectiveSummary] + attr_accessor next_token: ::String SENSITIVE: [] end @@ -110,11 +143,22 @@ module Aws::ControlCatalog class ObjectiveSummary attr_accessor arn: ::String - attr_accessor create_time: ::Time + attr_accessor name: ::String attr_accessor description: ::String attr_accessor domain: Types::AssociatedDomainSummary + attr_accessor create_time: ::Time attr_accessor last_update_time: ::Time - attr_accessor name: ::String + SENSITIVE: [] + end + + class RegionConfiguration + attr_accessor scope: ("GLOBAL" | "REGIONAL") + attr_accessor deployable_regions: ::Array[::String] + SENSITIVE: [] + end + + class ResourceNotFoundException + attr_accessor message: ::String SENSITIVE: [] end diff --git a/gems/aws-sdk-controltower/CHANGELOG.md b/gems/aws-sdk-controltower/CHANGELOG.md index 325841eeecd..01e9bcbd851 100644 --- a/gems/aws-sdk-controltower/CHANGELOG.md +++ b/gems/aws-sdk-controltower/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.27.0 (2024-08-01) +------------------ + +* Feature - Updated Control Tower service documentation for controlcatalog control ARN support with existing Control Tower public APIs + 1.26.0 (2024-07-02) ------------------ diff --git a/gems/aws-sdk-controltower/VERSION b/gems/aws-sdk-controltower/VERSION index 5ff8c4f5d2a..5db08bf2dc5 100644 --- a/gems/aws-sdk-controltower/VERSION +++ b/gems/aws-sdk-controltower/VERSION @@ -1 +1 @@ -1.26.0 +1.27.0 diff --git a/gems/aws-sdk-controltower/lib/aws-sdk-controltower.rb b/gems/aws-sdk-controltower/lib/aws-sdk-controltower.rb index b9d400e8c92..4d477932e49 100644 --- a/gems/aws-sdk-controltower/lib/aws-sdk-controltower.rb +++ b/gems/aws-sdk-controltower/lib/aws-sdk-controltower.rb @@ -52,6 +52,6 @@ # @!group service module Aws::ControlTower - GEM_VERSION = '1.26.0' + GEM_VERSION = '1.27.0' end diff --git a/gems/aws-sdk-controltower/lib/aws-sdk-controltower/client.rb b/gems/aws-sdk-controltower/lib/aws-sdk-controltower/client.rb index 6d4a5bd3475..c068d1fa196 100644 --- a/gems/aws-sdk-controltower/lib/aws-sdk-controltower/client.rb +++ b/gems/aws-sdk-controltower/lib/aws-sdk-controltower/client.rb @@ -1664,7 +1664,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-controltower' - context[:gem_version] = '1.26.0' + context[:gem_version] = '1.27.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-iam/CHANGELOG.md b/gems/aws-sdk-iam/CHANGELOG.md index bd3f89fc4c3..52ded124775 100644 --- a/gems/aws-sdk-iam/CHANGELOG.md +++ b/gems/aws-sdk-iam/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.104.0 (2024-08-01) +------------------ + +* Feature - Add v2 smoke tests and smithy smokeTests trait for SDK testing. + 1.103.0 (2024-07-02) ------------------ diff --git a/gems/aws-sdk-iam/VERSION b/gems/aws-sdk-iam/VERSION index e402df2ddc9..9f0b4661158 100644 --- a/gems/aws-sdk-iam/VERSION +++ b/gems/aws-sdk-iam/VERSION @@ -1 +1 @@ -1.103.0 +1.104.0 diff --git a/gems/aws-sdk-iam/features/smoke.feature b/gems/aws-sdk-iam/features/smoke.feature new file mode 100644 index 00000000000..09701fe58d3 --- /dev/null +++ b/gems/aws-sdk-iam/features/smoke.feature @@ -0,0 +1,32 @@ +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +Feature: Smoke tests for IAM + + @iam @smoke + Scenario: ListUsersSuccess + Given I create a 'Aws::IAM' client with config: + """ +{"region":"us-east-1"} + """ + When I call the operation 'list_users' with params: + """ +{} + """ + Then I expect an error was not raised + + @iam @smoke + Scenario: GetUserFailure + Given I create a 'Aws::IAM' client with config: + """ +{"region":"us-east-1"} + """ + When I call the operation 'get_user' with params: + """ +{"user_name":"fake_user"} + """ + Then I expect an error was raised diff --git a/gems/aws-sdk-iam/lib/aws-sdk-iam.rb b/gems/aws-sdk-iam/lib/aws-sdk-iam.rb index e65c05927d0..726c62c4b70 100644 --- a/gems/aws-sdk-iam/lib/aws-sdk-iam.rb +++ b/gems/aws-sdk-iam/lib/aws-sdk-iam.rb @@ -74,6 +74,6 @@ # @!group service module Aws::IAM - GEM_VERSION = '1.103.0' + GEM_VERSION = '1.104.0' end diff --git a/gems/aws-sdk-iam/lib/aws-sdk-iam/client.rb b/gems/aws-sdk-iam/lib/aws-sdk-iam/client.rb index d79306e560b..97ba0f97786 100644 --- a/gems/aws-sdk-iam/lib/aws-sdk-iam/client.rb +++ b/gems/aws-sdk-iam/lib/aws-sdk-iam/client.rb @@ -13512,7 +13512,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-iam' - context[:gem_version] = '1.103.0' + context[:gem_version] = '1.104.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-memorydb/CHANGELOG.md b/gems/aws-sdk-memorydb/CHANGELOG.md index f0540be2918..53ca85ca6ed 100644 --- a/gems/aws-sdk-memorydb/CHANGELOG.md +++ b/gems/aws-sdk-memorydb/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.31.0 (2024-08-01) +------------------ + +* Feature - Doc only update for changes to deletion API. + 1.30.0 (2024-07-29) ------------------ diff --git a/gems/aws-sdk-memorydb/VERSION b/gems/aws-sdk-memorydb/VERSION index 034552a83ee..34aae156b19 100644 --- a/gems/aws-sdk-memorydb/VERSION +++ b/gems/aws-sdk-memorydb/VERSION @@ -1 +1 @@ -1.30.0 +1.31.0 diff --git a/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb.rb b/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb.rb index 3fd09f0ccd9..fb95eb5f482 100644 --- a/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb.rb +++ b/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb.rb @@ -52,6 +52,6 @@ # @!group service module Aws::MemoryDB - GEM_VERSION = '1.30.0' + GEM_VERSION = '1.31.0' end diff --git a/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb/client.rb b/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb/client.rb index 32ef7cf5bf6..713740a8cc6 100644 --- a/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb/client.rb +++ b/gems/aws-sdk-memorydb/lib/aws-sdk-memorydb/client.rb @@ -1179,6 +1179,12 @@ def delete_acl(params = {}, options = {}) # Deletes a cluster. It also deletes all associated nodes and node # endpoints # + # `CreateSnapshot` permission is required to create a final snapshot. + # Without this permission, the API call will fail with an `Access + # Denied` exception. + # + # + # # @option params [required, String] :cluster_name # The name of the cluster to be deleted # @@ -2954,7 +2960,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-memorydb' - context[:gem_version] = '1.30.0' + context[:gem_version] = '1.31.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-rds/CHANGELOG.md b/gems/aws-sdk-rds/CHANGELOG.md index 3a568268216..ddb26aecd2f 100644 --- a/gems/aws-sdk-rds/CHANGELOG.md +++ b/gems/aws-sdk-rds/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.241.0 (2024-08-01) +------------------ + +* Feature - This release adds support for specifying optional MinACU parameter in CreateDBShardGroup and ModifyDBShardGroup API. DBShardGroup response will contain MinACU if specified. + 1.240.0 (2024-07-18) ------------------ diff --git a/gems/aws-sdk-rds/VERSION b/gems/aws-sdk-rds/VERSION index da705872466..5972a65683c 100644 --- a/gems/aws-sdk-rds/VERSION +++ b/gems/aws-sdk-rds/VERSION @@ -1 +1 @@ -1.240.0 +1.241.0 diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds.rb index 1e8584ed905..0a014d0950e 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds.rb @@ -78,6 +78,6 @@ # @!group service module Aws::RDS - GEM_VERSION = '1.240.0' + GEM_VERSION = '1.241.0' end diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/client.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/client.rb index 0ea9057c73a..d470aa5b0bd 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/client.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/client.rb @@ -1118,12 +1118,16 @@ def cancel_export_task(params = {}, options = {}) # A description for the copied DB cluster parameter group. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::CopyDBClusterParameterGroupResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -1354,12 +1358,16 @@ def copy_db_cluster_parameter_group(params = {}, options = {}) # to the target DB cluster snapshot. By default, tags are not copied. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [String] :source_region # The source region of the snapshot. This is only needed when the @@ -1509,12 +1517,16 @@ def copy_db_cluster_snapshot(params = {}, options = {}) # A description for the copied DB parameter group. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::CopyDBParameterGroupResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -1658,12 +1670,16 @@ def copy_db_parameter_group(params = {}, options = {}) # another Amazon Web Services Region. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [Boolean] :copy_tags # Specifies whether to copy all tags from the source DB snapshot to the @@ -1916,12 +1932,16 @@ def copy_db_snapshot(params = {}, options = {}) # The description for the copied option group. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::CopyOptionGroupResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -2377,12 +2397,16 @@ def create_blue_green_deployment(params = {}, options = {}) # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [String] :source_custom_db_engine_version_identifier # The ARN of a CEV to use as a source for creating a new CEV. You can @@ -6075,12 +6099,16 @@ def create_db_instance(params = {}, options = {}) # For more information, see CreateDBInstance. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [String] :db_subnet_group_name # A DB subnet group for the DB instance. The new DB instance is created @@ -7156,12 +7184,16 @@ def create_db_proxy(params = {}, options = {}) # Microsoft SQL Server support is `READ_WRITE`. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::CreateDBProxyEndpointResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -7338,6 +7370,10 @@ def create_db_security_group(params = {}, options = {}) # The maximum capacity of the DB shard group in Aurora capacity units # (ACUs). # + # @option params [Float] :min_acu + # The minimum capacity of the DB shard group in Aurora capacity units + # (ACUs). + # # @option params [Boolean] :publicly_accessible # Specifies whether the DB shard group is publicly accessible. # @@ -7379,6 +7415,7 @@ def create_db_security_group(params = {}, options = {}) # * {Types::DBShardGroup#db_shard_group_identifier #db_shard_group_identifier} => String # * {Types::DBShardGroup#db_cluster_identifier #db_cluster_identifier} => String # * {Types::DBShardGroup#max_acu #max_acu} => Float + # * {Types::DBShardGroup#min_acu #min_acu} => Float # * {Types::DBShardGroup#compute_redundancy #compute_redundancy} => Integer # * {Types::DBShardGroup#status #status} => String # * {Types::DBShardGroup#publicly_accessible #publicly_accessible} => Boolean @@ -7391,6 +7428,7 @@ def create_db_security_group(params = {}, options = {}) # db_cluster_identifier: "String", # required # compute_redundancy: 1, # max_acu: 1.0, # required + # min_acu: 1.0, # publicly_accessible: false, # }) # @@ -7400,6 +7438,7 @@ def create_db_security_group(params = {}, options = {}) # resp.db_shard_group_identifier #=> String # resp.db_cluster_identifier #=> String # resp.max_acu #=> Float + # resp.min_acu #=> Float # resp.compute_redundancy #=> Integer # resp.status #=> String # resp.publicly_accessible #=> Boolean @@ -7443,12 +7482,16 @@ def create_db_shard_group(params = {}, options = {}) # ^ # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::CreateDBSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -7794,12 +7837,16 @@ def create_db_subnet_group(params = {}, options = {}) # created but not active. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::CreateEventSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -8108,12 +8155,16 @@ def create_global_cluster(params = {}, options = {}) # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [String] :data_filter # Data filtering options for the integration. For more information, see @@ -8410,12 +8461,16 @@ def create_option_group(params = {}, options = {}) # The `NCHAR` value for the tenant database. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::CreateTenantDatabaseResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -8868,14 +8923,14 @@ def delete_custom_db_engine_version(params = {}, options = {}) # # @option params [Boolean] :skip_final_snapshot # Specifies whether to skip the creation of a final DB cluster snapshot - # before the DB cluster is deleted. If skip is specified, no DB cluster - # snapshot is created. If skip isn't specified, a DB cluster snapshot - # is created before the DB cluster is deleted. By default, skip isn't - # specified, and the DB cluster snapshot is created. By default, this - # parameter is disabled. + # before RDS deletes the DB cluster. If you set this value to `true`, + # RDS doesn't create a final DB cluster snapshot. If you set this value + # to `false` or don't specify it, RDS creates a DB cluster snapshot + # before it deletes the DB cluster. By default, this parameter is + # disabled, so RDS creates a final DB cluster snapshot. # - # You must specify a `FinalDBSnapshotIdentifier` parameter if - # `SkipFinalSnapshot` is disabled. + # If `SkipFinalSnapshot` is disabled, you must specify a value for the + # `FinalDBSnapshotIdentifier` parameter. # # # @@ -8883,9 +8938,9 @@ def delete_custom_db_engine_version(params = {}, options = {}) # The DB cluster snapshot identifier of the new DB cluster snapshot # created when `SkipFinalSnapshot` is disabled. # - # Specifying this parameter and also skipping the creation of a final DB - # cluster snapshot with the `SkipFinalShapshot` parameter results in an - # error. + # If you specify this parameter and also skip the creation of a final DB + # cluster snapshot with the `SkipFinalShapshot` parameter, the request + # results in an error. # # # @@ -8903,16 +8958,6 @@ def delete_custom_db_engine_version(params = {}, options = {}) # is to remove automated backups immediately after the DB cluster is # deleted. # - # You must delete automated backups for Amazon RDS Multi-AZ DB clusters. - # For more information about managing automated backups for RDS Multi-AZ - # DB clusters, see [Managing automated backups][1]. - # - # - # - # - # - # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ManagingAutomatedBackups.html - # # @return [Types::DeleteDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteDBClusterResult#db_cluster #db_cluster} => Types::DBCluster @@ -10023,6 +10068,7 @@ def delete_db_security_group(params = {}, options = {}) # * {Types::DBShardGroup#db_shard_group_identifier #db_shard_group_identifier} => String # * {Types::DBShardGroup#db_cluster_identifier #db_cluster_identifier} => String # * {Types::DBShardGroup#max_acu #max_acu} => Float + # * {Types::DBShardGroup#min_acu #min_acu} => Float # * {Types::DBShardGroup#compute_redundancy #compute_redundancy} => Integer # * {Types::DBShardGroup#status #status} => String # * {Types::DBShardGroup#publicly_accessible #publicly_accessible} => Boolean @@ -10040,6 +10086,7 @@ def delete_db_security_group(params = {}, options = {}) # resp.db_shard_group_identifier #=> String # resp.db_cluster_identifier #=> String # resp.max_acu #=> Float + # resp.min_acu #=> Float # resp.compute_redundancy #=> Integer # resp.status #=> String # resp.publicly_accessible #=> Boolean @@ -11747,7 +11794,7 @@ def describe_db_cluster_parameter_groups(params = {}, options = {}) # # Valid Values: # - # * `user` + # * `customer` # # * `engine` # @@ -14325,6 +14372,7 @@ def describe_db_security_groups(params = {}, options = {}) # resp.db_shard_groups[0].db_shard_group_identifier #=> String # resp.db_shard_groups[0].db_cluster_identifier #=> String # resp.db_shard_groups[0].max_acu #=> Float + # resp.db_shard_groups[0].min_acu #=> Float # resp.db_shard_groups[0].compute_redundancy #=> Integer # resp.db_shard_groups[0].status #=> String # resp.db_shard_groups[0].publicly_accessible #=> Boolean @@ -21730,12 +21778,17 @@ def modify_db_recommendation(params = {}, options = {}) # The maximum capacity of the DB shard group in Aurora capacity units # (ACUs). # + # @option params [Float] :min_acu + # The minimum capacity of the DB shard group in Aurora capacity units + # (ACUs). + # # @return [Types::DBShardGroup] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DBShardGroup#db_shard_group_resource_id #db_shard_group_resource_id} => String # * {Types::DBShardGroup#db_shard_group_identifier #db_shard_group_identifier} => String # * {Types::DBShardGroup#db_cluster_identifier #db_cluster_identifier} => String # * {Types::DBShardGroup#max_acu #max_acu} => Float + # * {Types::DBShardGroup#min_acu #min_acu} => Float # * {Types::DBShardGroup#compute_redundancy #compute_redundancy} => Integer # * {Types::DBShardGroup#status #status} => String # * {Types::DBShardGroup#publicly_accessible #publicly_accessible} => Boolean @@ -21746,6 +21799,7 @@ def modify_db_recommendation(params = {}, options = {}) # resp = client.modify_db_shard_group({ # db_shard_group_identifier: "DBShardGroupIdentifier", # required # max_acu: 1.0, + # min_acu: 1.0, # }) # # @example Response structure @@ -21754,6 +21808,7 @@ def modify_db_recommendation(params = {}, options = {}) # resp.db_shard_group_identifier #=> String # resp.db_cluster_identifier #=> String # resp.max_acu #=> Float + # resp.min_acu #=> Float # resp.compute_redundancy #=> Integer # resp.status #=> String # resp.publicly_accessible #=> Boolean @@ -23240,12 +23295,16 @@ def promote_read_replica_db_cluster(params = {}, options = {}) # Default: `1` # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @return [Types::PurchaseReservedDBInstancesOfferingResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -23780,6 +23839,7 @@ def reboot_db_instance(params = {}, options = {}) # * {Types::DBShardGroup#db_shard_group_identifier #db_shard_group_identifier} => String # * {Types::DBShardGroup#db_cluster_identifier #db_cluster_identifier} => String # * {Types::DBShardGroup#max_acu #max_acu} => Float + # * {Types::DBShardGroup#min_acu #min_acu} => Float # * {Types::DBShardGroup#compute_redundancy #compute_redundancy} => Integer # * {Types::DBShardGroup#status #status} => String # * {Types::DBShardGroup#publicly_accessible #publicly_accessible} => Boolean @@ -23797,6 +23857,7 @@ def reboot_db_instance(params = {}, options = {}) # resp.db_shard_group_identifier #=> String # resp.db_cluster_identifier #=> String # resp.max_acu #=> Float + # resp.min_acu #=> Float # resp.compute_redundancy #=> Integer # resp.status #=> String # resp.publicly_accessible #=> Boolean @@ -24569,12 +24630,16 @@ def reset_db_parameter_group(params = {}, options = {}) # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [Boolean] :storage_encrypted # Specifies whether the restored DB cluster is encrypted. @@ -25976,12 +26041,16 @@ def restore_db_cluster_from_snapshot(params = {}, options = {}) # Valid for: Aurora DB clusters and Multi-AZ DB clusters # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [String] :kms_key_id # The Amazon Web Services KMS key identifier to use when restoring an @@ -26815,12 +26884,16 @@ def restore_db_cluster_to_point_in_time(params = {}, options = {}) # This setting doesn't apply to RDS Custom. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [String] :storage_type # Specifies the storage type to be associated with the DB instance. @@ -28510,12 +28583,16 @@ def restore_db_instance_from_s3(params = {}, options = {}) # snapshots of the DB instance. By default, tags are not copied. # # @option params [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # # @option params [String] :storage_type # The storage type to associate with the DB instance. @@ -31281,7 +31358,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-rds' - context[:gem_version] = '1.240.0' + context[:gem_version] = '1.241.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/client_api.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/client_api.rb index 7506eab93b7..71f3d9fe805 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/client_api.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/client_api.rb @@ -1267,6 +1267,7 @@ module ClientApi CreateDBShardGroupMessage.add_member(:db_cluster_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBClusterIdentifier")) CreateDBShardGroupMessage.add_member(:compute_redundancy, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "ComputeRedundancy")) CreateDBShardGroupMessage.add_member(:max_acu, Shapes::ShapeRef.new(shape: DoubleOptional, required: true, location_name: "MaxACU")) + CreateDBShardGroupMessage.add_member(:min_acu, Shapes::ShapeRef.new(shape: DoubleOptional, location_name: "MinACU")) CreateDBShardGroupMessage.add_member(:publicly_accessible, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "PubliclyAccessible")) CreateDBShardGroupMessage.struct_class = Types::CreateDBShardGroupMessage @@ -2018,6 +2019,7 @@ module ClientApi DBShardGroup.add_member(:db_shard_group_identifier, Shapes::ShapeRef.new(shape: DBShardGroupIdentifier, location_name: "DBShardGroupIdentifier")) DBShardGroup.add_member(:db_cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBClusterIdentifier")) DBShardGroup.add_member(:max_acu, Shapes::ShapeRef.new(shape: DoubleOptional, location_name: "MaxACU")) + DBShardGroup.add_member(:min_acu, Shapes::ShapeRef.new(shape: DoubleOptional, location_name: "MinACU")) DBShardGroup.add_member(:compute_redundancy, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "ComputeRedundancy")) DBShardGroup.add_member(:status, Shapes::ShapeRef.new(shape: String, location_name: "Status")) DBShardGroup.add_member(:publicly_accessible, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "PubliclyAccessible")) @@ -3212,6 +3214,7 @@ module ClientApi ModifyDBShardGroupMessage.add_member(:db_shard_group_identifier, Shapes::ShapeRef.new(shape: DBShardGroupIdentifier, required: true, location_name: "DBShardGroupIdentifier")) ModifyDBShardGroupMessage.add_member(:max_acu, Shapes::ShapeRef.new(shape: DoubleOptional, location_name: "MaxACU")) + ModifyDBShardGroupMessage.add_member(:min_acu, Shapes::ShapeRef.new(shape: DoubleOptional, location_name: "MinACU")) ModifyDBShardGroupMessage.struct_class = Types::ModifyDBShardGroupMessage ModifyDBSnapshotAttributeMessage.add_member(:db_snapshot_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBSnapshotIdentifier")) diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster.rb index 779b4edb6e1..439a2085009 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster.rb @@ -455,12 +455,16 @@ def domain_memberships data[:domain_memberships] end - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] def tag_list data[:tag_list] @@ -1822,23 +1826,23 @@ def create_snapshot(options = {}) # @param [Hash] options ({}) # @option options [Boolean] :skip_final_snapshot # Specifies whether to skip the creation of a final DB cluster snapshot - # before the DB cluster is deleted. If skip is specified, no DB cluster - # snapshot is created. If skip isn't specified, a DB cluster snapshot - # is created before the DB cluster is deleted. By default, skip isn't - # specified, and the DB cluster snapshot is created. By default, this - # parameter is disabled. + # before RDS deletes the DB cluster. If you set this value to `true`, + # RDS doesn't create a final DB cluster snapshot. If you set this value + # to `false` or don't specify it, RDS creates a DB cluster snapshot + # before it deletes the DB cluster. By default, this parameter is + # disabled, so RDS creates a final DB cluster snapshot. # - # You must specify a `FinalDBSnapshotIdentifier` parameter if - # `SkipFinalSnapshot` is disabled. + # If `SkipFinalSnapshot` is disabled, you must specify a value for the + # `FinalDBSnapshotIdentifier` parameter. # # # @option options [String] :final_db_snapshot_identifier # The DB cluster snapshot identifier of the new DB cluster snapshot # created when `SkipFinalSnapshot` is disabled. # - # Specifying this parameter and also skipping the creation of a final DB - # cluster snapshot with the `SkipFinalShapshot` parameter results in an - # error. + # If you specify this parameter and also skip the creation of a final DB + # cluster snapshot with the `SkipFinalShapshot` parameter, the request + # results in an error. # # # @@ -1854,16 +1858,6 @@ def create_snapshot(options = {}) # cluster is deleted. This parameter isn't case-sensitive. The default # is to remove automated backups immediately after the DB cluster is # deleted. - # - # You must delete automated backups for Amazon RDS Multi-AZ DB clusters. - # For more information about managing automated backups for RDS Multi-AZ - # DB clusters, see [Managing automated backups][1]. - # - # - # - # - # - # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ManagingAutomatedBackups.html # @return [DBCluster] def delete(options = {}) options = options.merge(db_cluster_identifier: @id) @@ -2755,12 +2749,16 @@ def modify(options = {}) # # Valid for: Aurora DB clusters and Multi-AZ DB clusters # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @option options [String] :kms_key_id # The Amazon Web Services KMS key identifier to use when restoring an # encrypted DB cluster from an encrypted DB cluster. diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster_snapshot.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster_snapshot.rb index dbf3e9c2667..1f41664aa41 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster_snapshot.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_cluster_snapshot.rb @@ -177,12 +177,16 @@ def iam_database_authentication_enabled data[:iam_database_authentication_enabled] end - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] def tag_list data[:tag_list] @@ -500,12 +504,16 @@ def create(options = {}) # Specifies whether to copy all tags from the source DB cluster snapshot # to the target DB cluster snapshot. By default, tags are not copied. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @option options [String] :source_region # The source region of the snapshot. This is only needed when the # shapshot is encrypted and in a different region. diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_engine_version.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_engine_version.rb index a628c863e09..c8a2386a12e 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_engine_version.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_engine_version.rb @@ -220,12 +220,16 @@ def create_time data[:create_time] end - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] def tag_list data[:tag_list] diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_instance.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_instance.rb index c65837dfbe0..63070393ae7 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_instance.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_instance.rb @@ -549,12 +549,16 @@ def max_allocated_storage data[:max_allocated_storage] end - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] def tag_list data[:tag_list] @@ -2395,12 +2399,16 @@ def create(options = {}) # # For more information, see CreateDBInstance. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @option options [String] :db_subnet_group_name # A DB subnet group for the DB instance. The new DB instance is created # in the VPC associated with the DB subnet group. If no DB subnet group @@ -2912,12 +2920,16 @@ def create_read_replica(options = {}) # # Example: `my-snapshot-id` # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [DBSnapshot] def create_snapshot(options = {}) options = options.merge(db_instance_identifier: @id) @@ -4452,12 +4464,16 @@ def reboot(options = {}) # Specifies whether to copy all tags from the restored DB instance to # snapshots of the DB instance. By default, tags are not copied. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @option options [String] :storage_type # The storage type to associate with the DB instance. # diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_parameter_group.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_parameter_group.rb index 32560ad2ab0..6e7c0b12f0f 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_parameter_group.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_parameter_group.rb @@ -304,12 +304,16 @@ def create(options = {}) # @option options [required, String] :target_db_parameter_group_description # A description for the copied DB parameter group. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [DBParameterGroup] def copy(options = {}) options = options.merge(source_db_parameter_group_identifier: @name) diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_snapshot.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_snapshot.rb index eda9750addb..a98f3693b42 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/db_snapshot.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/db_snapshot.rb @@ -219,12 +219,16 @@ def dbi_resource_id data[:dbi_resource_id] end - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] def tag_list data[:tag_list] @@ -438,12 +442,16 @@ def wait_until(options = {}, &block) # }) # @param [Hash] options ({}) # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [DBSnapshot] def create(options = {}) options = options.merge( @@ -519,12 +527,16 @@ def create(options = {}) # in, and you can't use KMS keys from one Amazon Web Services Region in # another Amazon Web Services Region. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @option options [Boolean] :copy_tags # Specifies whether to copy all tags from the source DB snapshot to the # target DB snapshot. By default, tags aren't copied. @@ -892,12 +904,16 @@ def delete(options = {}) # # This setting doesn't apply to RDS Custom. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @option options [String] :storage_type # Specifies the storage type to be associated with the DB instance. # diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/event_subscription.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/event_subscription.rb index 61ca35d6754..59c1506460d 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/event_subscription.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/event_subscription.rb @@ -371,12 +371,16 @@ def add_subscriber(options = {}) # notification subscription isn't activated, the subscription is # created but not active. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [EventSubscription] def create(options = {}) options = options.merge(subscription_name: @name) diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/option_group.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/option_group.rb index 74c134d7b23..bf2a86e6cae 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/option_group.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/option_group.rb @@ -337,12 +337,16 @@ def create(options = {}) # @option options [required, String] :target_option_group_description # The description for the copied option group. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [OptionGroup] def copy(options = {}) options = options.merge(source_option_group_identifier: @name) diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/reserved_db_instances_offering.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/reserved_db_instances_offering.rb index 72c0128d2ca..5ec1eba2715 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/reserved_db_instances_offering.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/reserved_db_instances_offering.rb @@ -249,12 +249,16 @@ def wait_until(options = {}, &block) # # Default: `1` # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [ReservedDBInstance] def purchase(options = {}) options = options.merge(reserved_db_instances_offering_id: @id) diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/resource.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/resource.rb index df128c8b6e8..3ce742f40bc 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/resource.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/resource.rb @@ -2650,12 +2650,16 @@ def create_db_subnet_group(options = {}) # notification subscription isn't activated, the subscription is # created but not active. # @option options [Array] :tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [EventSubscription] def create_event_subscription(options = {}) resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do diff --git a/gems/aws-sdk-rds/lib/aws-sdk-rds/types.rb b/gems/aws-sdk-rds/lib/aws-sdk-rds/types.rb index b6c9a24333a..2dbcc506cba 100644 --- a/gems/aws-sdk-rds/lib/aws-sdk-rds/types.rb +++ b/gems/aws-sdk-rds/lib/aws-sdk-rds/types.rb @@ -612,12 +612,16 @@ class BackupPolicyNotFoundFault < Aws::EmptyStructure; end # @return [Time] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/BlueGreenDeployment AWS API Documentation @@ -1184,12 +1188,16 @@ class ContextAttribute < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBClusterParameterGroupMessage AWS API Documentation @@ -1352,12 +1360,16 @@ class CopyDBClusterParameterGroupResult < Struct.new( # @return [Boolean] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] source_region @@ -1431,12 +1443,16 @@ class CopyDBClusterSnapshotResult < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBParameterGroupMessage AWS API Documentation @@ -1538,12 +1554,16 @@ class CopyDBParameterGroupResult < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] copy_tags @@ -1719,12 +1739,16 @@ class CopyDBSnapshotResult < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyOptionGroupMessage AWS API Documentation @@ -1973,12 +1997,16 @@ class CreateCustomDBEngineVersionFault < Aws::EmptyStructure; end # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] source_custom_db_engine_version_identifier @@ -4861,12 +4889,16 @@ class CreateDBInstanceMessage < Struct.new( # @return [Boolean] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] db_subnet_group_name @@ -5646,12 +5678,16 @@ class CreateDBParameterGroupResult < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBProxyEndpointRequest AWS API Documentation @@ -5852,6 +5888,11 @@ class CreateDBSecurityGroupResult < Struct.new( # (ACUs). # @return [Float] # + # @!attribute [rw] min_acu + # The minimum capacity of the DB shard group in Aurora capacity units + # (ACUs). + # @return [Float] + # # @!attribute [rw] publicly_accessible # Specifies whether the DB shard group is publicly accessible. # @@ -5896,6 +5937,7 @@ class CreateDBShardGroupMessage < Struct.new( :db_cluster_identifier, :compute_redundancy, :max_acu, + :min_acu, :publicly_accessible) SENSITIVE = [] include Aws::Structure @@ -5929,12 +5971,16 @@ class CreateDBShardGroupMessage < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshotMessage AWS API Documentation @@ -6104,12 +6150,16 @@ class CreateDBSubnetGroupResult < Struct.new( # @return [Boolean] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateEventSubscriptionMessage AWS API Documentation @@ -6316,12 +6366,16 @@ class CreateGlobalClusterResult < Struct.new( # @return [Hash] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] data_filter @@ -6484,12 +6538,16 @@ class CreateOptionGroupResult < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateTenantDatabaseMessage AWS API Documentation @@ -6913,12 +6971,16 @@ class CustomDBEngineVersionQuotaExceededFault < Aws::EmptyStructure; end # @return [Array] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] global_write_forwarding_status @@ -8037,12 +8099,16 @@ class DBClusterRoleQuotaExceededFault < Aws::EmptyStructure; end # @return [Boolean] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] db_system_id @@ -8373,12 +8439,16 @@ class DBClusterStatusInfo < Struct.new( # @return [Time] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] supports_babelfish @@ -8915,12 +8985,16 @@ class DBEngineVersionMessage < Struct.new( # @return [Integer] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] db_instance_automated_backups_replications @@ -10464,6 +10538,11 @@ class DBSecurityGroupQuotaExceededFault < Aws::EmptyStructure; end # (ACUs). # @return [Float] # + # @!attribute [rw] min_acu + # The minimum capacity of the DB shard group in Aurora capacity units + # (ACUs). + # @return [Float] + # # @!attribute [rw] compute_redundancy # Specifies whether to create standby instances for the DB shard # group. Valid values are the following: @@ -10514,6 +10593,7 @@ class DBShardGroup < Struct.new( :db_shard_group_identifier, :db_cluster_identifier, :max_acu, + :min_acu, :compute_redundancy, :status, :publicly_accessible, @@ -10674,12 +10754,16 @@ class DBShardGroupNotFoundFault < Aws::EmptyStructure; end # @return [String] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] original_snapshot_create_time @@ -10917,12 +11001,16 @@ class DBSnapshotNotFoundFault < Aws::EmptyStructure; end # @return [String] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBSnapshotTenantDatabase AWS API Documentation @@ -11236,14 +11324,14 @@ class DeleteDBClusterEndpointMessage < Struct.new( # # @!attribute [rw] skip_final_snapshot # Specifies whether to skip the creation of a final DB cluster - # snapshot before the DB cluster is deleted. If skip is specified, no - # DB cluster snapshot is created. If skip isn't specified, a DB - # cluster snapshot is created before the DB cluster is deleted. By - # default, skip isn't specified, and the DB cluster snapshot is - # created. By default, this parameter is disabled. + # snapshot before RDS deletes the DB cluster. If you set this value to + # `true`, RDS doesn't create a final DB cluster snapshot. If you set + # this value to `false` or don't specify it, RDS creates a DB cluster + # snapshot before it deletes the DB cluster. By default, this + # parameter is disabled, so RDS creates a final DB cluster snapshot. # - # You must specify a `FinalDBSnapshotIdentifier` parameter if - # `SkipFinalSnapshot` is disabled. + # If `SkipFinalSnapshot` is disabled, you must specify a value for the + # `FinalDBSnapshotIdentifier` parameter. # # # @return [Boolean] @@ -11252,9 +11340,9 @@ class DeleteDBClusterEndpointMessage < Struct.new( # The DB cluster snapshot identifier of the new DB cluster snapshot # created when `SkipFinalSnapshot` is disabled. # - # Specifying this parameter and also skipping the creation of a final - # DB cluster snapshot with the `SkipFinalShapshot` parameter results - # in an error. + # If you specify this parameter and also skip the creation of a final + # DB cluster snapshot with the `SkipFinalShapshot` parameter, the + # request results in an error. # # # @@ -11272,16 +11360,6 @@ class DeleteDBClusterEndpointMessage < Struct.new( # DB cluster is deleted. This parameter isn't case-sensitive. The # default is to remove automated backups immediately after the DB # cluster is deleted. - # - # You must delete automated backups for Amazon RDS Multi-AZ DB - # clusters. For more information about managing automated backups for - # RDS Multi-AZ DB clusters, see [Managing automated backups][1]. - # - # - # - # - # - # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ManagingAutomatedBackups.html # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterMessage AWS API Documentation @@ -12245,7 +12323,7 @@ class DescribeDBClusterParameterGroupsMessage < Struct.new( # # Valid Values: # - # * `user` + # * `customer` # # * `engine` # @@ -16217,12 +16295,16 @@ class InsufficientStorageClusterCapacityFault < Aws::EmptyStructure; end # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] create_time @@ -19422,11 +19504,17 @@ class ModifyDBRecommendationMessage < Struct.new( # (ACUs). # @return [Float] # + # @!attribute [rw] min_acu + # The minimum capacity of the DB shard group in Aurora capacity units + # (ACUs). + # @return [Float] + # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBShardGroupMessage AWS API Documentation # class ModifyDBShardGroupMessage < Struct.new( :db_shard_group_identifier, - :max_acu) + :max_acu, + :min_acu) SENSITIVE = [] include Aws::Structure end @@ -19998,7 +20086,7 @@ class Option < Struct.new( include Aws::Structure end - # A list of all available options + # A list of all available options for an option group. # # @!attribute [rw] option_name # The configuration of options to include in a group. @@ -20013,13 +20101,11 @@ class Option < Struct.new( # @return [String] # # @!attribute [rw] db_security_group_memberships - # A list of DBSecurityGroupMembership name strings used for this - # option. + # A list of DB security groups used for this option. # @return [Array] # # @!attribute [rw] vpc_security_group_memberships - # A list of VpcSecurityGroupMembership name strings used for this - # option. + # A list of VPC security group names used for this option. # @return [Array] # # @!attribute [rw] option_settings @@ -21416,12 +21502,16 @@ class ProvisionedIopsNotAvailableInAZFault < Aws::EmptyStructure; end # @return [Integer] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PurchaseReservedDBInstancesOfferingMessage AWS API Documentation @@ -22463,12 +22553,16 @@ class ResourcePendingMaintenanceActions < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] storage_encrypted @@ -23496,12 +23590,16 @@ class RestoreDBClusterFromSnapshotResult < Struct.new( # @return [Array] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] kms_key_id @@ -24152,12 +24250,16 @@ class RestoreDBClusterToPointInTimeResult < Struct.new( # @return [String] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] storage_type @@ -25560,12 +25662,16 @@ class RestoreDBInstanceFromS3Result < Struct.new( # @return [Boolean] # # @!attribute [rw] tags - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @!attribute [rw] storage_type @@ -27252,9 +27358,9 @@ class SwitchoverReadReplicaResult < Struct.new( # Metadata assigned to an Amazon RDS resource consisting of a key-value # pair. # - # For more information, see [Tagging Amazon RDS Resources][1] in the + # For more information, see [Tagging Amazon RDS resources][1] in the # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS - # Resources][2] in the *Amazon Aurora User Guide*. + # resources][2] in the *Amazon Aurora User Guide*. # # # @@ -27385,12 +27491,16 @@ class TargetHealth < Struct.new( # @return [Types::TenantDatabasePendingModifiedValues] # # @!attribute [rw] tag_list - # A list of tags. For more information, see [Tagging Amazon RDS - # Resources][1] in the *Amazon RDS User Guide.* + # A list of tags. + # + # For more information, see [Tagging Amazon RDS resources][1] in the + # *Amazon RDS User Guide* or [Tagging Amazon Aurora and Amazon RDS + # resources][2] in the *Amazon Aurora User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html + # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/TenantDatabase AWS API Documentation diff --git a/gems/aws-sdk-rds/sig/client.rbs b/gems/aws-sdk-rds/sig/client.rbs index 9dcd58f1766..7e0882fa53e 100644 --- a/gems/aws-sdk-rds/sig/client.rbs +++ b/gems/aws-sdk-rds/sig/client.rbs @@ -748,6 +748,7 @@ module Aws def db_shard_group_identifier: () -> ::String def db_cluster_identifier: () -> ::String def max_acu: () -> ::Float + def min_acu: () -> ::Float def compute_redundancy: () -> ::Integer def status: () -> ::String def publicly_accessible: () -> bool @@ -759,6 +760,7 @@ module Aws db_cluster_identifier: ::String, ?compute_redundancy: ::Integer, max_acu: ::Float, + ?min_acu: ::Float, ?publicly_accessible: bool ) -> _CreateDBShardGroupResponseSuccess | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateDBShardGroupResponseSuccess @@ -1084,6 +1086,7 @@ module Aws def db_shard_group_identifier: () -> ::String def db_cluster_identifier: () -> ::String def max_acu: () -> ::Float + def min_acu: () -> ::Float def compute_redundancy: () -> ::Integer def status: () -> ::String def publicly_accessible: () -> bool @@ -2537,6 +2540,7 @@ module Aws def db_shard_group_identifier: () -> ::String def db_cluster_identifier: () -> ::String def max_acu: () -> ::Float + def min_acu: () -> ::Float def compute_redundancy: () -> ::Integer def status: () -> ::String def publicly_accessible: () -> bool @@ -2545,7 +2549,8 @@ module Aws # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/RDS/Client.html#modify_db_shard_group-instance_method def modify_db_shard_group: ( db_shard_group_identifier: ::String, - ?max_acu: ::Float + ?max_acu: ::Float, + ?min_acu: ::Float ) -> _ModifyDBShardGroupResponseSuccess | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ModifyDBShardGroupResponseSuccess @@ -2752,6 +2757,7 @@ module Aws def db_shard_group_identifier: () -> ::String def db_cluster_identifier: () -> ::String def max_acu: () -> ::Float + def min_acu: () -> ::Float def compute_redundancy: () -> ::Integer def status: () -> ::String def publicly_accessible: () -> bool diff --git a/gems/aws-sdk-rds/sig/types.rbs b/gems/aws-sdk-rds/sig/types.rbs index e7ad3a291d7..35ee4b652df 100644 --- a/gems/aws-sdk-rds/sig/types.rbs +++ b/gems/aws-sdk-rds/sig/types.rbs @@ -619,6 +619,7 @@ module Aws::RDS attr_accessor db_cluster_identifier: ::String attr_accessor compute_redundancy: ::Integer attr_accessor max_acu: ::Float + attr_accessor min_acu: ::Float attr_accessor publicly_accessible: bool SENSITIVE: [] end @@ -1483,6 +1484,7 @@ module Aws::RDS attr_accessor db_shard_group_identifier: ::String attr_accessor db_cluster_identifier: ::String attr_accessor max_acu: ::Float + attr_accessor min_acu: ::Float attr_accessor compute_redundancy: ::Integer attr_accessor status: ::String attr_accessor publicly_accessible: bool @@ -3008,6 +3010,7 @@ module Aws::RDS class ModifyDBShardGroupMessage attr_accessor db_shard_group_identifier: ::String attr_accessor max_acu: ::Float + attr_accessor min_acu: ::Float SENSITIVE: [] end diff --git a/gems/aws-sdk-resources/CHANGELOG.md b/gems/aws-sdk-resources/CHANGELOG.md index ed9486c1fe9..f2634716895 100644 --- a/gems/aws-sdk-resources/CHANGELOG.md +++ b/gems/aws-sdk-resources/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +3.200.0 (2024-08-01) +------------------ + +* Feature - Added a dependency on the new `aws-sdk-ssmquicksetup` gem. + 3.199.0 (2024-07-23) ------------------ diff --git a/gems/aws-sdk-resources/VERSION b/gems/aws-sdk-resources/VERSION index cd17c0d7d69..5386ab60d78 100644 --- a/gems/aws-sdk-resources/VERSION +++ b/gems/aws-sdk-resources/VERSION @@ -1 +1 @@ -3.199.0 +3.200.0 diff --git a/gems/aws-sdk-resources/aws-sdk-resources.gemspec b/gems/aws-sdk-resources/aws-sdk-resources.gemspec index be4621a7c9a..948879cbf4a 100644 --- a/gems/aws-sdk-resources/aws-sdk-resources.gemspec +++ b/gems/aws-sdk-resources/aws-sdk-resources.gemspec @@ -342,6 +342,7 @@ Gem::Specification.new do |spec| spec.add_dependency('aws-sdk-ssm', '~> 1') spec.add_dependency('aws-sdk-ssmcontacts', '~> 1') spec.add_dependency('aws-sdk-ssmincidents', '~> 1') + spec.add_dependency('aws-sdk-ssmquicksetup', '~> 1') spec.add_dependency('aws-sdk-ssoadmin', '~> 1') spec.add_dependency('aws-sdk-swf', '~> 1') spec.add_dependency('aws-sdk-sagemaker', '~> 1') diff --git a/gems/aws-sdk-resources/lib/aws-sdk-resources.rb b/gems/aws-sdk-resources/lib/aws-sdk-resources.rb index 468d23fb4f6..8fed65aea16 100644 --- a/gems/aws-sdk-resources/lib/aws-sdk-resources.rb +++ b/gems/aws-sdk-resources/lib/aws-sdk-resources.rb @@ -332,6 +332,7 @@ module Aws autoload :SSM, 'aws-sdk-ssm' autoload :SSMContacts, 'aws-sdk-ssmcontacts' autoload :SSMIncidents, 'aws-sdk-ssmincidents' + autoload :SSMQuickSetup, 'aws-sdk-ssmquicksetup' autoload :SSO, 'aws-sdk-core' autoload :SSOAdmin, 'aws-sdk-ssoadmin' autoload :SSOOIDC, 'aws-sdk-core' diff --git a/gems/aws-sdk-s3/CHANGELOG.md b/gems/aws-sdk-s3/CHANGELOG.md index 9d83dda7e6e..85acf38af87 100644 --- a/gems/aws-sdk-s3/CHANGELOG.md +++ b/gems/aws-sdk-s3/CHANGELOG.md @@ -1,6 +1,9 @@ Unreleased Changes ------------------ +1.157.0 (2024-08-01) +------------------ + * Feature - Support `head_bucket`, `get_object_attributes`, `delete_objects`, and `copy_object` for Access Grants. 1.156.0 (2024-07-02) diff --git a/gems/aws-sdk-s3/VERSION b/gems/aws-sdk-s3/VERSION index e855ab6cce4..36ebe49cbdd 100644 --- a/gems/aws-sdk-s3/VERSION +++ b/gems/aws-sdk-s3/VERSION @@ -1 +1 @@ -1.156.0 +1.157.0 diff --git a/gems/aws-sdk-s3/lib/aws-sdk-s3.rb b/gems/aws-sdk-s3/lib/aws-sdk-s3.rb index 5ea7de3c3a9..7b9289aae12 100644 --- a/gems/aws-sdk-s3/lib/aws-sdk-s3.rb +++ b/gems/aws-sdk-s3/lib/aws-sdk-s3.rb @@ -73,6 +73,6 @@ # @!group service module Aws::S3 - GEM_VERSION = '1.156.0' + GEM_VERSION = '1.157.0' end diff --git a/gems/aws-sdk-s3/lib/aws-sdk-s3/client.rb b/gems/aws-sdk-s3/lib/aws-sdk-s3/client.rb index 049e8c0e899..859b16fccf3 100644 --- a/gems/aws-sdk-s3/lib/aws-sdk-s3/client.rb +++ b/gems/aws-sdk-s3/lib/aws-sdk-s3/client.rb @@ -18863,7 +18863,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-s3' - context[:gem_version] = '1.156.0' + context[:gem_version] = '1.157.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-sagemaker/CHANGELOG.md b/gems/aws-sdk-sagemaker/CHANGELOG.md index 77371c58b46..f7d3ae17018 100644 --- a/gems/aws-sdk-sagemaker/CHANGELOG.md +++ b/gems/aws-sdk-sagemaker/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.255.0 (2024-08-01) +------------------ + +* Feature - This release adds support for Amazon EMR Serverless applications in SageMaker Studio for running data processing jobs. + 1.254.0 (2024-07-18) ------------------ diff --git a/gems/aws-sdk-sagemaker/VERSION b/gems/aws-sdk-sagemaker/VERSION index 9b3b978703e..31aba6e0ce4 100644 --- a/gems/aws-sdk-sagemaker/VERSION +++ b/gems/aws-sdk-sagemaker/VERSION @@ -1 +1 @@ -1.254.0 +1.255.0 diff --git a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker.rb b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker.rb index 3d0e5ef9e4d..fbcc44c2dc0 100644 --- a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker.rb +++ b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker.rb @@ -53,6 +53,6 @@ # @!group service module Aws::SageMaker - GEM_VERSION = '1.254.0' + GEM_VERSION = '1.255.0' end diff --git a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client.rb b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client.rb index 46f8d0b329d..912f69dd861 100644 --- a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client.rb +++ b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client.rb @@ -2643,6 +2643,10 @@ def create_device_fleet(params = {}, options = {}) # repository_url: "RepositoryUrl", # required # }, # ], + # emr_settings: { + # assumable_role_arns: ["RoleArn"], + # execution_role_arns: ["RoleArn"], + # }, # }, # space_storage_settings: { # default_ebs_storage_settings: { @@ -2761,6 +2765,10 @@ def create_device_fleet(params = {}, options = {}) # repository_url: "RepositoryUrl", # required # }, # ], + # emr_settings: { + # assumable_role_arns: ["RoleArn"], + # execution_role_arns: ["RoleArn"], + # }, # }, # space_storage_settings: { # default_ebs_storage_settings: { @@ -9374,6 +9382,10 @@ def create_trial_component(params = {}, options = {}) # repository_url: "RepositoryUrl", # required # }, # ], + # emr_settings: { + # assumable_role_arns: ["RoleArn"], + # execution_role_arns: ["RoleArn"], + # }, # }, # space_storage_settings: { # default_ebs_storage_settings: { @@ -12520,6 +12532,10 @@ def describe_device_fleet(params = {}, options = {}) # resp.default_user_settings.jupyter_lab_app_settings.lifecycle_config_arns[0] #=> String # resp.default_user_settings.jupyter_lab_app_settings.code_repositories #=> Array # resp.default_user_settings.jupyter_lab_app_settings.code_repositories[0].repository_url #=> String + # resp.default_user_settings.jupyter_lab_app_settings.emr_settings.assumable_role_arns #=> Array + # resp.default_user_settings.jupyter_lab_app_settings.emr_settings.assumable_role_arns[0] #=> String + # resp.default_user_settings.jupyter_lab_app_settings.emr_settings.execution_role_arns #=> Array + # resp.default_user_settings.jupyter_lab_app_settings.emr_settings.execution_role_arns[0] #=> String # resp.default_user_settings.space_storage_settings.default_ebs_storage_settings.default_ebs_volume_size_in_gb #=> Integer # resp.default_user_settings.space_storage_settings.default_ebs_storage_settings.maximum_ebs_volume_size_in_gb #=> Integer # resp.default_user_settings.default_landing_uri #=> String @@ -12593,6 +12609,10 @@ def describe_device_fleet(params = {}, options = {}) # resp.default_space_settings.jupyter_lab_app_settings.lifecycle_config_arns[0] #=> String # resp.default_space_settings.jupyter_lab_app_settings.code_repositories #=> Array # resp.default_space_settings.jupyter_lab_app_settings.code_repositories[0].repository_url #=> String + # resp.default_space_settings.jupyter_lab_app_settings.emr_settings.assumable_role_arns #=> Array + # resp.default_space_settings.jupyter_lab_app_settings.emr_settings.assumable_role_arns[0] #=> String + # resp.default_space_settings.jupyter_lab_app_settings.emr_settings.execution_role_arns #=> Array + # resp.default_space_settings.jupyter_lab_app_settings.emr_settings.execution_role_arns[0] #=> String # resp.default_space_settings.space_storage_settings.default_ebs_storage_settings.default_ebs_volume_size_in_gb #=> Integer # resp.default_space_settings.space_storage_settings.default_ebs_storage_settings.maximum_ebs_volume_size_in_gb #=> Integer # resp.default_space_settings.custom_posix_user_config.uid #=> Integer @@ -16597,6 +16617,10 @@ def describe_trial_component(params = {}, options = {}) # resp.user_settings.jupyter_lab_app_settings.lifecycle_config_arns[0] #=> String # resp.user_settings.jupyter_lab_app_settings.code_repositories #=> Array # resp.user_settings.jupyter_lab_app_settings.code_repositories[0].repository_url #=> String + # resp.user_settings.jupyter_lab_app_settings.emr_settings.assumable_role_arns #=> Array + # resp.user_settings.jupyter_lab_app_settings.emr_settings.assumable_role_arns[0] #=> String + # resp.user_settings.jupyter_lab_app_settings.emr_settings.execution_role_arns #=> Array + # resp.user_settings.jupyter_lab_app_settings.emr_settings.execution_role_arns[0] #=> String # resp.user_settings.space_storage_settings.default_ebs_storage_settings.default_ebs_volume_size_in_gb #=> Integer # resp.user_settings.space_storage_settings.default_ebs_storage_settings.maximum_ebs_volume_size_in_gb #=> Integer # resp.user_settings.default_landing_uri #=> String @@ -24967,6 +24991,10 @@ def update_devices(params = {}, options = {}) # repository_url: "RepositoryUrl", # required # }, # ], + # emr_settings: { + # assumable_role_arns: ["RoleArn"], + # execution_role_arns: ["RoleArn"], + # }, # }, # space_storage_settings: { # default_ebs_storage_settings: { @@ -25074,6 +25102,10 @@ def update_devices(params = {}, options = {}) # repository_url: "RepositoryUrl", # required # }, # ], + # emr_settings: { + # assumable_role_arns: ["RoleArn"], + # execution_role_arns: ["RoleArn"], + # }, # }, # space_storage_settings: { # default_ebs_storage_settings: { @@ -27174,6 +27206,10 @@ def update_trial_component(params = {}, options = {}) # repository_url: "RepositoryUrl", # required # }, # ], + # emr_settings: { + # assumable_role_arns: ["RoleArn"], + # execution_role_arns: ["RoleArn"], + # }, # }, # space_storage_settings: { # default_ebs_storage_settings: { @@ -27478,7 +27514,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-sagemaker' - context[:gem_version] = '1.254.0' + context[:gem_version] = '1.255.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client_api.rb b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client_api.rb index a23b252781d..e66f3e12413 100644 --- a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client_api.rb +++ b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/client_api.rb @@ -91,6 +91,7 @@ module ClientApi AssociationEntityArn = Shapes::StringShape.new(name: 'AssociationEntityArn') AssociationSummaries = Shapes::ListShape.new(name: 'AssociationSummaries') AssociationSummary = Shapes::StructureShape.new(name: 'AssociationSummary') + AssumableRoleArns = Shapes::ListShape.new(name: 'AssumableRoleArns') AsyncInferenceClientConfig = Shapes::StructureShape.new(name: 'AsyncInferenceClientConfig') AsyncInferenceConfig = Shapes::StructureShape.new(name: 'AsyncInferenceConfig') AsyncInferenceNotificationConfig = Shapes::StructureShape.new(name: 'AsyncInferenceNotificationConfig') @@ -808,6 +809,7 @@ module ClientApi EdgeVersion = Shapes::StringShape.new(name: 'EdgeVersion') Edges = Shapes::ListShape.new(name: 'Edges') EfsUid = Shapes::StringShape.new(name: 'EfsUid') + EmrSettings = Shapes::StructureShape.new(name: 'EmrSettings') EnableCapture = Shapes::BooleanShape.new(name: 'EnableCapture') EnableInfraCheck = Shapes::BooleanShape.new(name: 'EnableInfraCheck') EnableIotRoleAlias = Shapes::BooleanShape.new(name: 'EnableIotRoleAlias') @@ -848,6 +850,7 @@ module ClientApi EnvironmentParameters = Shapes::ListShape.new(name: 'EnvironmentParameters') EnvironmentValue = Shapes::StringShape.new(name: 'EnvironmentValue') ExcludeFeaturesAttribute = Shapes::StringShape.new(name: 'ExcludeFeaturesAttribute') + ExecutionRoleArns = Shapes::ListShape.new(name: 'ExecutionRoleArns') ExecutionRoleIdentityConfig = Shapes::StringShape.new(name: 'ExecutionRoleIdentityConfig') ExecutionStatus = Shapes::StringShape.new(name: 'ExecutionStatus') ExitMessage = Shapes::StringShape.new(name: 'ExitMessage') @@ -2544,6 +2547,8 @@ module ClientApi AssociationSummary.add_member(:created_by, Shapes::ShapeRef.new(shape: UserContext, location_name: "CreatedBy")) AssociationSummary.struct_class = Types::AssociationSummary + AssumableRoleArns.member = Shapes::ShapeRef.new(shape: RoleArn) + AsyncInferenceClientConfig.add_member(:max_concurrent_invocations_per_instance, Shapes::ShapeRef.new(shape: MaxConcurrentInvocationsPerInstance, location_name: "MaxConcurrentInvocationsPerInstance")) AsyncInferenceClientConfig.struct_class = Types::AsyncInferenceClientConfig @@ -5646,6 +5651,10 @@ module ClientApi Edges.member = Shapes::ShapeRef.new(shape: Edge) + EmrSettings.add_member(:assumable_role_arns, Shapes::ShapeRef.new(shape: AssumableRoleArns, location_name: "AssumableRoleArns")) + EmrSettings.add_member(:execution_role_arns, Shapes::ShapeRef.new(shape: ExecutionRoleArns, location_name: "ExecutionRoleArns")) + EmrSettings.struct_class = Types::EmrSettings + EnableSagemakerServicecatalogPortfolioInput.struct_class = Types::EnableSagemakerServicecatalogPortfolioInput EnableSagemakerServicecatalogPortfolioOutput.struct_class = Types::EnableSagemakerServicecatalogPortfolioOutput @@ -5738,6 +5747,8 @@ module ClientApi EnvironmentParameters.member = Shapes::ShapeRef.new(shape: EnvironmentParameter) + ExecutionRoleArns.member = Shapes::ShapeRef.new(shape: RoleArn) + Experiment.add_member(:experiment_name, Shapes::ShapeRef.new(shape: ExperimentEntityName, location_name: "ExperimentName")) Experiment.add_member(:experiment_arn, Shapes::ShapeRef.new(shape: ExperimentArn, location_name: "ExperimentArn")) Experiment.add_member(:display_name, Shapes::ShapeRef.new(shape: ExperimentEntityName, location_name: "DisplayName")) @@ -6441,6 +6452,7 @@ module ClientApi JupyterLabAppSettings.add_member(:custom_images, Shapes::ShapeRef.new(shape: CustomImages, location_name: "CustomImages")) JupyterLabAppSettings.add_member(:lifecycle_config_arns, Shapes::ShapeRef.new(shape: LifecycleConfigArns, location_name: "LifecycleConfigArns")) JupyterLabAppSettings.add_member(:code_repositories, Shapes::ShapeRef.new(shape: CodeRepositories, location_name: "CodeRepositories")) + JupyterLabAppSettings.add_member(:emr_settings, Shapes::ShapeRef.new(shape: EmrSettings, location_name: "EmrSettings")) JupyterLabAppSettings.struct_class = Types::JupyterLabAppSettings JupyterServerAppSettings.add_member(:default_resource_spec, Shapes::ShapeRef.new(shape: ResourceSpec, location_name: "DefaultResourceSpec")) diff --git a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/types.rb b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/types.rb index f5cbc4e47df..a0b22a61509 100644 --- a/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/types.rb +++ b/gems/aws-sdk-sagemaker/lib/aws-sdk-sagemaker/types.rb @@ -19302,6 +19302,44 @@ class EdgePresetDeploymentOutput < Struct.new( include Aws::Structure end + # The configuration parameters that specify the IAM roles assumed by the + # execution role of SageMaker (assumable roles) and the cluster + # instances or job execution environments (execution roles or runtime + # roles) to manage and access resources required for running Amazon EMR + # clusters or Amazon EMR Serverless applications. + # + # @!attribute [rw] assumable_role_arns + # An array of Amazon Resource Names (ARNs) of the IAM roles that the + # execution role of SageMaker can assume for performing operations or + # tasks related to Amazon EMR clusters or Amazon EMR Serverless + # applications. These roles define the permissions and access policies + # required when performing Amazon EMR-related operations, such as + # listing, connecting to, or terminating Amazon EMR clusters or Amazon + # EMR Serverless applications. They are typically used in + # cross-account access scenarios, where the Amazon EMR resources + # (clusters or serverless applications) are located in a different + # Amazon Web Services account than the SageMaker domain. + # @return [Array] + # + # @!attribute [rw] execution_role_arns + # An array of Amazon Resource Names (ARNs) of the IAM roles used by + # the Amazon EMR cluster instances or job execution environments to + # access other Amazon Web Services services and resources needed + # during the runtime of your Amazon EMR or Amazon EMR Serverless + # workloads, such as Amazon S3 for data access, Amazon CloudWatch for + # logging, or other Amazon Web Services services based on the + # particular workload requirements. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/EmrSettings AWS API Documentation + # + class EmrSettings < Struct.new( + :assumable_role_arns, + :execution_role_arns) + SENSITIVE = [] + include Aws::Structure + end + # @api private # # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/EnableSagemakerServicecatalogPortfolioInput AWS API Documentation @@ -24841,13 +24879,22 @@ class JupyterLabAppImageConfig < Struct.new( # users for cloning in the JupyterLab application. # @return [Array] # + # @!attribute [rw] emr_settings + # The configuration parameters that specify the IAM roles assumed by + # the execution role of SageMaker (assumable roles) and the cluster + # instances or job execution environments (execution roles or runtime + # roles) to manage and access resources required for running Amazon + # EMR clusters or Amazon EMR Serverless applications. + # @return [Types::EmrSettings] + # # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/JupyterLabAppSettings AWS API Documentation # class JupyterLabAppSettings < Struct.new( :default_resource_spec, :custom_images, :lifecycle_config_arns, - :code_repositories) + :code_repositories, + :emr_settings) SENSITIVE = [] include Aws::Structure end diff --git a/gems/aws-sdk-sagemaker/sig/client.rbs b/gems/aws-sdk-sagemaker/sig/client.rbs index 8de3b3c71cf..c9e3cd49c2a 100644 --- a/gems/aws-sdk-sagemaker/sig/client.rbs +++ b/gems/aws-sdk-sagemaker/sig/client.rbs @@ -1080,7 +1080,11 @@ module Aws { repository_url: ::String }, - ]? + ]?, + emr_settings: { + assumable_role_arns: Array[::String]?, + execution_role_arns: Array[::String]? + }? }?, space_storage_settings: { default_ebs_storage_settings: { @@ -1198,7 +1202,11 @@ module Aws { repository_url: ::String }, - ]? + ]?, + emr_settings: { + assumable_role_arns: Array[::String]?, + execution_role_arns: Array[::String]? + }? }?, space_storage_settings: { default_ebs_storage_settings: { @@ -4111,7 +4119,11 @@ module Aws { repository_url: ::String }, - ]? + ]?, + emr_settings: { + assumable_role_arns: Array[::String]?, + execution_role_arns: Array[::String]? + }? }?, space_storage_settings: { default_ebs_storage_settings: { @@ -8209,7 +8221,11 @@ module Aws { repository_url: ::String }, - ]? + ]?, + emr_settings: { + assumable_role_arns: Array[::String]?, + execution_role_arns: Array[::String]? + }? }?, space_storage_settings: { default_ebs_storage_settings: { @@ -8316,7 +8332,11 @@ module Aws { repository_url: ::String }, - ]? + ]?, + emr_settings: { + assumable_role_arns: Array[::String]?, + execution_role_arns: Array[::String]? + }? }?, space_storage_settings: { default_ebs_storage_settings: { @@ -9276,7 +9296,11 @@ module Aws { repository_url: ::String }, - ]? + ]?, + emr_settings: { + assumable_role_arns: Array[::String]?, + execution_role_arns: Array[::String]? + }? }?, space_storage_settings: { default_ebs_storage_settings: { diff --git a/gems/aws-sdk-sagemaker/sig/types.rbs b/gems/aws-sdk-sagemaker/sig/types.rbs index 159f2e5c304..34f3004493a 100644 --- a/gems/aws-sdk-sagemaker/sig/types.rbs +++ b/gems/aws-sdk-sagemaker/sig/types.rbs @@ -4119,6 +4119,12 @@ module Aws::SageMaker SENSITIVE: [] end + class EmrSettings + attr_accessor assumable_role_arns: ::Array[::String] + attr_accessor execution_role_arns: ::Array[::String] + SENSITIVE: [] + end + class EnableSagemakerServicecatalogPortfolioInput < Aws::EmptyStructure end @@ -5012,6 +5018,7 @@ module Aws::SageMaker attr_accessor custom_images: ::Array[Types::CustomImage] attr_accessor lifecycle_config_arns: ::Array[::String] attr_accessor code_repositories: ::Array[Types::CodeRepository] + attr_accessor emr_settings: Types::EmrSettings SENSITIVE: [] end diff --git a/gems/aws-sdk-ssmquicksetup/CHANGELOG.md b/gems/aws-sdk-ssmquicksetup/CHANGELOG.md new file mode 100644 index 00000000000..a6e777c9452 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/CHANGELOG.md @@ -0,0 +1,8 @@ +Unreleased Changes +------------------ + +1.0.0 (2024-08-01) +------------------ + +* Feature - Initial release of `aws-sdk-ssmquicksetup`. + diff --git a/gems/aws-sdk-ssmquicksetup/LICENSE.txt b/gems/aws-sdk-ssmquicksetup/LICENSE.txt new file mode 100644 index 00000000000..d6456956733 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/LICENSE.txt @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/gems/aws-sdk-ssmquicksetup/VERSION b/gems/aws-sdk-ssmquicksetup/VERSION new file mode 100644 index 00000000000..3eefcb9dd5b --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/VERSION @@ -0,0 +1 @@ +1.0.0 diff --git a/gems/aws-sdk-ssmquicksetup/aws-sdk-ssmquicksetup.gemspec b/gems/aws-sdk-ssmquicksetup/aws-sdk-ssmquicksetup.gemspec new file mode 100644 index 00000000000..939d93df89c --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/aws-sdk-ssmquicksetup.gemspec @@ -0,0 +1,32 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +Gem::Specification.new do |spec| + + spec.name = 'aws-sdk-ssmquicksetup' + spec.version = File.read(File.expand_path('../VERSION', __FILE__)).strip + spec.summary = 'AWS SDK for Ruby - AWS Systems Manager QuickSetup' + spec.description = 'Official AWS Ruby gem for AWS Systems Manager QuickSetup. This gem is part of the AWS SDK for Ruby.' + spec.author = 'Amazon Web Services' + spec.homepage = 'https://github.com/aws/aws-sdk-ruby' + spec.license = 'Apache-2.0' + spec.email = ['aws-dr-rubygems@amazon.com'] + spec.require_paths = ['lib'] + spec.files = Dir["LICENSE.txt", "CHANGELOG.md", "VERSION", "lib/**/*.rb", "sig/**/*.rbs"] + + spec.metadata = { + 'source_code_uri' => 'https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-ssmquicksetup', + 'changelog_uri' => 'https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-ssmquicksetup/CHANGELOG.md' + } + + spec.add_dependency('aws-sdk-core', '~> 3', '>= 3.201.0') + spec.add_dependency('aws-sigv4', '~> 1.5') + + spec.required_ruby_version = '>= 2.5' +end diff --git a/gems/aws-sdk-ssmquicksetup/features/env.rb b/gems/aws-sdk-ssmquicksetup/features/env.rb new file mode 100644 index 00000000000..49fceb31863 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/features/env.rb @@ -0,0 +1,18 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +$:.unshift(File.expand_path('../../lib', __FILE__)) +$:.unshift(File.expand_path('../../../aws-sdk-core/features', __FILE__)) +$:.unshift(File.expand_path('../../../aws-sdk-core/lib', __FILE__)) +$:.unshift(File.expand_path('../../../aws-sigv4/lib', __FILE__)) + +require 'features_helper' +require 'aws-sdk-ssmquicksetup' + +Aws::SSMQuickSetup::Client.add_plugin(ApiCallTracker) diff --git a/gems/aws-sdk-ssmquicksetup/features/step_definitions.rb b/gems/aws-sdk-ssmquicksetup/features/step_definitions.rb new file mode 100644 index 00000000000..4734747f18b --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/features/step_definitions.rb @@ -0,0 +1,8 @@ +Before("@ssmquicksetup") do + @service = Aws::SSMQuickSetup::Resource.new + @client = @service.client +end + +After("@ssmquicksetup") do + # shared cleanup logic +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup.rb new file mode 100644 index 00000000000..3fd8be52d65 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup.rb @@ -0,0 +1,57 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + + +require 'aws-sdk-core' +require 'aws-sigv4' + +require_relative 'aws-sdk-ssmquicksetup/types' +require_relative 'aws-sdk-ssmquicksetup/client_api' +require_relative 'aws-sdk-ssmquicksetup/plugins/endpoints.rb' +require_relative 'aws-sdk-ssmquicksetup/client' +require_relative 'aws-sdk-ssmquicksetup/errors' +require_relative 'aws-sdk-ssmquicksetup/resource' +require_relative 'aws-sdk-ssmquicksetup/endpoint_parameters' +require_relative 'aws-sdk-ssmquicksetup/endpoint_provider' +require_relative 'aws-sdk-ssmquicksetup/endpoints' +require_relative 'aws-sdk-ssmquicksetup/customizations' + +# This module provides support for AWS Systems Manager QuickSetup. This module is available in the +# `aws-sdk-ssmquicksetup` gem. +# +# # Client +# +# The {Client} class provides one method for each API operation. Operation +# methods each accept a hash of request parameters and return a response +# structure. +# +# ssm_quick_setup = Aws::SSMQuickSetup::Client.new +# resp = ssm_quick_setup.create_configuration_manager(params) +# +# See {Client} for more information. +# +# # Errors +# +# Errors returned from AWS Systems Manager QuickSetup are defined in the +# {Errors} module and all extend {Errors::ServiceError}. +# +# begin +# # do stuff +# rescue Aws::SSMQuickSetup::Errors::ServiceError +# # rescues all AWS Systems Manager QuickSetup API errors +# end +# +# See {Errors} for more information. +# +# @!group service +module Aws::SSMQuickSetup + + GEM_VERSION = '1.0.0' + +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/client.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/client.rb new file mode 100644 index 00000000000..8d4cf9e64fe --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/client.rb @@ -0,0 +1,882 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +require 'seahorse/client/plugins/content_length.rb' +require 'aws-sdk-core/plugins/credentials_configuration.rb' +require 'aws-sdk-core/plugins/logging.rb' +require 'aws-sdk-core/plugins/param_converter.rb' +require 'aws-sdk-core/plugins/param_validator.rb' +require 'aws-sdk-core/plugins/user_agent.rb' +require 'aws-sdk-core/plugins/helpful_socket_errors.rb' +require 'aws-sdk-core/plugins/retry_errors.rb' +require 'aws-sdk-core/plugins/global_configuration.rb' +require 'aws-sdk-core/plugins/regional_endpoint.rb' +require 'aws-sdk-core/plugins/endpoint_discovery.rb' +require 'aws-sdk-core/plugins/endpoint_pattern.rb' +require 'aws-sdk-core/plugins/response_paging.rb' +require 'aws-sdk-core/plugins/stub_responses.rb' +require 'aws-sdk-core/plugins/idempotency_token.rb' +require 'aws-sdk-core/plugins/invocation_id.rb' +require 'aws-sdk-core/plugins/jsonvalue_converter.rb' +require 'aws-sdk-core/plugins/client_metrics_plugin.rb' +require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb' +require 'aws-sdk-core/plugins/transfer_encoding.rb' +require 'aws-sdk-core/plugins/http_checksum.rb' +require 'aws-sdk-core/plugins/checksum_algorithm.rb' +require 'aws-sdk-core/plugins/request_compression.rb' +require 'aws-sdk-core/plugins/defaults_mode.rb' +require 'aws-sdk-core/plugins/recursion_detection.rb' +require 'aws-sdk-core/plugins/sign.rb' +require 'aws-sdk-core/plugins/protocols/rest_json.rb' + +Aws::Plugins::GlobalConfiguration.add_identifier(:ssmquicksetup) + +module Aws::SSMQuickSetup + # An API client for SSMQuickSetup. To construct a client, you need to configure a `:region` and `:credentials`. + # + # client = Aws::SSMQuickSetup::Client.new( + # region: region_name, + # credentials: credentials, + # # ... + # ) + # + # For details on configuring region and credentials see + # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html). + # + # See {#initialize} for a full list of supported configuration options. + class Client < Seahorse::Client::Base + + include Aws::ClientStubs + + @identifier = :ssmquicksetup + + set_api(ClientApi::API) + + add_plugin(Seahorse::Client::Plugins::ContentLength) + add_plugin(Aws::Plugins::CredentialsConfiguration) + add_plugin(Aws::Plugins::Logging) + add_plugin(Aws::Plugins::ParamConverter) + add_plugin(Aws::Plugins::ParamValidator) + add_plugin(Aws::Plugins::UserAgent) + add_plugin(Aws::Plugins::HelpfulSocketErrors) + add_plugin(Aws::Plugins::RetryErrors) + add_plugin(Aws::Plugins::GlobalConfiguration) + add_plugin(Aws::Plugins::RegionalEndpoint) + add_plugin(Aws::Plugins::EndpointDiscovery) + add_plugin(Aws::Plugins::EndpointPattern) + add_plugin(Aws::Plugins::ResponsePaging) + add_plugin(Aws::Plugins::StubResponses) + add_plugin(Aws::Plugins::IdempotencyToken) + add_plugin(Aws::Plugins::InvocationId) + add_plugin(Aws::Plugins::JsonvalueConverter) + add_plugin(Aws::Plugins::ClientMetricsPlugin) + add_plugin(Aws::Plugins::ClientMetricsSendPlugin) + add_plugin(Aws::Plugins::TransferEncoding) + add_plugin(Aws::Plugins::HttpChecksum) + add_plugin(Aws::Plugins::ChecksumAlgorithm) + add_plugin(Aws::Plugins::RequestCompression) + add_plugin(Aws::Plugins::DefaultsMode) + add_plugin(Aws::Plugins::RecursionDetection) + add_plugin(Aws::Plugins::Sign) + add_plugin(Aws::Plugins::Protocols::RestJson) + add_plugin(Aws::SSMQuickSetup::Plugins::Endpoints) + + # @overload initialize(options) + # @param [Hash] options + # + # @option options [Array] :plugins ([]]) + # A list of plugins to apply to the client. Each plugin is either a + # class name or an instance of a plugin class. + # + # @option options [required, Aws::CredentialProvider] :credentials + # Your AWS credentials. This can be an instance of any one of the + # following classes: + # + # * `Aws::Credentials` - Used for configuring static, non-refreshing + # credentials. + # + # * `Aws::SharedCredentials` - Used for loading static credentials from a + # shared file, such as `~/.aws/config`. + # + # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role. + # + # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to + # assume a role after providing credentials via the web. + # + # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an + # access token generated from `aws login`. + # + # * `Aws::ProcessCredentials` - Used for loading credentials from a + # process that outputs to stdout. + # + # * `Aws::InstanceProfileCredentials` - Used for loading credentials + # from an EC2 IMDS on an EC2 instance. + # + # * `Aws::ECSCredentials` - Used for loading credentials from + # instances running in ECS. + # + # * `Aws::CognitoIdentityCredentials` - Used for loading credentials + # from the Cognito Identity service. + # + # When `:credentials` are not configured directly, the following + # locations will be searched for credentials: + # + # * `Aws.config[:credentials]` + # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options. + # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'] + # * `~/.aws/credentials` + # * `~/.aws/config` + # * EC2/ECS IMDS instance profile - When used by default, the timeouts + # are very aggressive. Construct and pass an instance of + # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to + # enable retries and extended timeouts. Instance profile credential + # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED'] + # to true. + # + # @option options [required, String] :region + # The AWS region to connect to. The configured `:region` is + # used to determine the service `:endpoint`. When not passed, + # a default `:region` is searched for in the following locations: + # + # * `Aws.config[:region]` + # * `ENV['AWS_REGION']` + # * `ENV['AMAZON_REGION']` + # * `ENV['AWS_DEFAULT_REGION']` + # * `~/.aws/credentials` + # * `~/.aws/config` + # + # @option options [String] :access_key_id + # + # @option options [Boolean] :active_endpoint_cache (false) + # When set to `true`, a thread polling for endpoints will be running in + # the background every 60 secs (default). Defaults to `false`. + # + # @option options [Boolean] :adaptive_retry_wait_to_fill (true) + # Used only in `adaptive` retry mode. When true, the request will sleep + # until there is sufficent client side capacity to retry the request. + # When false, the request will raise a `RetryCapacityNotAvailableError` and will + # not retry instead of sleeping. + # + # @option options [Boolean] :client_side_monitoring (false) + # When `true`, client-side metrics will be collected for all API requests from + # this client. + # + # @option options [String] :client_side_monitoring_client_id ("") + # Allows you to provide an identifier for this client which will be attached to + # all generated client side metrics. Defaults to an empty string. + # + # @option options [String] :client_side_monitoring_host ("127.0.0.1") + # Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client + # side monitoring agent is running on, where client metrics will be published via UDP. + # + # @option options [Integer] :client_side_monitoring_port (31000) + # Required for publishing client metrics. The port that the client side monitoring + # agent is running on, where client metrics will be published via UDP. + # + # @option options [Aws::ClientSideMonitoring::Publisher] :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) + # Allows you to provide a custom client-side monitoring publisher class. By default, + # will use the Client Side Monitoring Agent Publisher. + # + # @option options [Boolean] :convert_params (true) + # When `true`, an attempt is made to coerce request parameters into + # the required types. + # + # @option options [Boolean] :correct_clock_skew (true) + # Used only in `standard` and adaptive retry modes. Specifies whether to apply + # a clock skew correction and retry requests with skewed client clocks. + # + # @option options [String] :defaults_mode ("legacy") + # See {Aws::DefaultsModeConfiguration} for a list of the + # accepted modes and the configuration defaults that are included. + # + # @option options [Boolean] :disable_host_prefix_injection (false) + # Set to true to disable SDK automatically adding host prefix + # to default service endpoint when available. + # + # @option options [Boolean] :disable_request_compression (false) + # When set to 'true' the request body will not be compressed + # for supported operations. + # + # @option options [String, URI::HTTPS, URI::HTTP] :endpoint + # Normally you should not configure the `:endpoint` option + # directly. This is normally constructed from the `:region` + # option. Configuring `:endpoint` is normally reserved for + # connecting to test or custom endpoints. The endpoint should + # be a URI formatted like: + # + # 'http://example.com' + # 'https://example.com' + # 'http://example.com:123' + # + # @option options [Integer] :endpoint_cache_max_entries (1000) + # Used for the maximum size limit of the LRU cache storing endpoints data + # for endpoint discovery enabled operations. Defaults to 1000. + # + # @option options [Integer] :endpoint_cache_max_threads (10) + # Used for the maximum threads in use for polling endpoints to be cached, defaults to 10. + # + # @option options [Integer] :endpoint_cache_poll_interval (60) + # When :endpoint_discovery and :active_endpoint_cache is enabled, + # Use this option to config the time interval in seconds for making + # requests fetching endpoints information. Defaults to 60 sec. + # + # @option options [Boolean] :endpoint_discovery (false) + # When set to `true`, endpoint discovery will be enabled for operations when available. + # + # @option options [Boolean] :ignore_configured_endpoint_urls + # Setting to true disables use of endpoint URLs provided via environment + # variables and the shared configuration file. + # + # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default) + # The log formatter. + # + # @option options [Symbol] :log_level (:info) + # The log level to send messages to the `:logger` at. + # + # @option options [Logger] :logger + # The Logger instance to send log messages to. If this option + # is not set, logging will be disabled. + # + # @option options [Integer] :max_attempts (3) + # An integer representing the maximum number attempts that will be made for + # a single request, including the initial attempt. For example, + # setting this value to 5 will result in a request being retried up to + # 4 times. Used in `standard` and `adaptive` retry modes. + # + # @option options [String] :profile ("default") + # Used when loading credentials from the shared credentials file + # at HOME/.aws/credentials. When not specified, 'default' is used. + # + # @option options [Integer] :request_min_compression_size_bytes (10240) + # The minimum size in bytes that triggers compression for request + # bodies. The value must be non-negative integer value between 0 + # and 10485780 bytes inclusive. + # + # @option options [Proc] :retry_backoff + # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay. + # This option is only used in the `legacy` retry mode. + # + # @option options [Float] :retry_base_delay (0.3) + # The base delay in seconds used by the default backoff function. This option + # is only used in the `legacy` retry mode. + # + # @option options [Symbol] :retry_jitter (:none) + # A delay randomiser function used by the default backoff function. + # Some predefined functions can be referenced by name - :none, :equal, :full, + # otherwise a Proc that takes and returns a number. This option is only used + # in the `legacy` retry mode. + # + # @see https://www.awsarchitectureblog.com/2015/03/backoff.html + # + # @option options [Integer] :retry_limit (3) + # The maximum number of times to retry failed requests. Only + # ~ 500 level server errors and certain ~ 400 level client errors + # are retried. Generally, these are throttling errors, data + # checksum errors, networking errors, timeout errors, auth errors, + # endpoint discovery, and errors from expired credentials. + # This option is only used in the `legacy` retry mode. + # + # @option options [Integer] :retry_max_delay (0) + # The maximum number of seconds to delay between retries (0 for no limit) + # used by the default backoff function. This option is only used in the + # `legacy` retry mode. + # + # @option options [String] :retry_mode ("legacy") + # Specifies which retry algorithm to use. Values are: + # + # * `legacy` - The pre-existing retry behavior. This is default value if + # no retry mode is provided. + # + # * `standard` - A standardized set of retry rules across the AWS SDKs. + # This includes support for retry quotas, which limit the number of + # unsuccessful retries a client can make. + # + # * `adaptive` - An experimental retry mode that includes all the + # functionality of `standard` mode along with automatic client side + # throttling. This is a provisional mode that may change behavior + # in the future. + # + # @option options [String] :sdk_ua_app_id + # A unique and opaque application ID that is appended to the + # User-Agent header as app/sdk_ua_app_id. It should have a + # maximum length of 50. This variable is sourced from environment + # variable AWS_SDK_UA_APP_ID or the shared config profile attribute sdk_ua_app_id. + # + # @option options [String] :secret_access_key + # + # @option options [String] :session_token + # + # @option options [Array] :sigv4a_signing_region_set + # A list of regions that should be signed with SigV4a signing. When + # not passed, a default `:sigv4a_signing_region_set` is searched for + # in the following locations: + # + # * `Aws.config[:sigv4a_signing_region_set]` + # * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']` + # * `~/.aws/config` + # + # @option options [Boolean] :stub_responses (false) + # Causes the client to return stubbed responses. By default + # fake responses are generated and returned. You can specify + # the response data to return or errors to raise by calling + # {ClientStubs#stub_responses}. See {ClientStubs} for more information. + # + # ** Please note ** When response stubbing is enabled, no HTTP + # requests are made, and retries are disabled. + # + # @option options [Aws::TokenProvider] :token_provider + # A Bearer Token Provider. This can be an instance of any one of the + # following classes: + # + # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing + # tokens. + # + # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an + # access token generated from `aws login`. + # + # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain` + # will be used to search for tokens configured for your profile in shared configuration files. + # + # @option options [Boolean] :use_dualstack_endpoint + # When set to `true`, dualstack enabled endpoints (with `.aws` TLD) + # will be used if available. + # + # @option options [Boolean] :use_fips_endpoint + # When set to `true`, fips compatible endpoints will be used if available. + # When a `fips` region is used, the region is normalized and this config + # is set to `true`. + # + # @option options [Boolean] :validate_params (true) + # When `true`, request parameters are validated before + # sending the request. + # + # @option options [Aws::SSMQuickSetup::EndpointProvider] :endpoint_provider + # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::SSMQuickSetup::EndpointParameters` + # + # @option options [Float] :http_continue_timeout (1) + # The number of seconds to wait for a 100-continue response before sending the + # request body. This option has no effect unless the request has "Expect" + # header set to "100-continue". Defaults to `nil` which disables this + # behaviour. This value can safely be set per request on the session. + # + # @option options [Float] :http_idle_timeout (5) + # The number of seconds a connection is allowed to sit idle before it + # is considered stale. Stale connections are closed and removed from the + # pool before making a request. + # + # @option options [Float] :http_open_timeout (15) + # The default number of seconds to wait for response data. + # This value can safely be set per-request on the session. + # + # @option options [URI::HTTP,String] :http_proxy + # A proxy to send requests through. Formatted like 'http://proxy.com:123'. + # + # @option options [Float] :http_read_timeout (60) + # The default number of seconds to wait for response data. + # This value can safely be set per-request on the session. + # + # @option options [Boolean] :http_wire_trace (false) + # When `true`, HTTP debug output will be sent to the `:logger`. + # + # @option options [Proc] :on_chunk_received + # When a Proc object is provided, it will be used as callback when each chunk + # of the response body is received. It provides three arguments: the chunk, + # the number of bytes received, and the total number of + # bytes in the response (or nil if the server did not send a `content-length`). + # + # @option options [Proc] :on_chunk_sent + # When a Proc object is provided, it will be used as callback when each chunk + # of the request body is sent. It provides three arguments: the chunk, + # the number of bytes read from the body, and the total number of + # bytes in the body. + # + # @option options [Boolean] :raise_response_errors (true) + # When `true`, response errors are raised. + # + # @option options [String] :ssl_ca_bundle + # Full path to the SSL certificate authority bundle file that should be used when + # verifying peer certificates. If you do not pass `:ssl_ca_bundle` or + # `:ssl_ca_directory` the the system default will be used if available. + # + # @option options [String] :ssl_ca_directory + # Full path of the directory that contains the unbundled SSL certificate + # authority files for verifying peer certificates. If you do + # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system + # default will be used if available. + # + # @option options [String] :ssl_ca_store + # Sets the X509::Store to verify peer certificate. + # + # @option options [Float] :ssl_timeout + # Sets the SSL timeout in seconds + # + # @option options [Boolean] :ssl_verify_peer (true) + # When `true`, SSL peer certificates are verified when establishing a connection. + # + def initialize(*args) + super + end + + # @!group API Operations + + # Creates a Quick Setup configuration manager resource. This object is a + # collection of desired state configurations for multiple configuration + # definitions and summaries describing the deployments of those + # definitions. + # + # @option params [required, Array] :configuration_definitions + # The definition of the Quick Setup configuration that the configuration + # manager deploys. + # + # @option params [String] :description + # A description of the configuration manager. + # + # @option params [String] :name + # A name for the configuration manager. + # + # @option params [Hash] :tags + # Key-value pairs of metadata to assign to the configuration manager. + # + # @return [Types::CreateConfigurationManagerOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::CreateConfigurationManagerOutput#manager_arn #manager_arn} => String + # + # @example Request syntax with placeholder values + # + # resp = client.create_configuration_manager({ + # configuration_definitions: [ # required + # { + # local_deployment_administration_role_arn: "IAMRoleArn", + # local_deployment_execution_role_name: "ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString", + # parameters: { # required + # "ConfigurationParametersMapKeyString" => "ConfigurationParametersMapValueString", + # }, + # type: "ConfigurationDefinitionInputTypeString", # required + # type_version: "ConfigurationDefinitionInputTypeVersionString", + # }, + # ], + # description: "CreateConfigurationManagerInputDescriptionString", + # name: "CreateConfigurationManagerInputNameString", + # tags: { + # "TagsMapKeyString" => "TagsMapValueString", + # }, + # }) + # + # @example Response structure + # + # resp.manager_arn #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/CreateConfigurationManager AWS API Documentation + # + # @overload create_configuration_manager(params = {}) + # @param [Hash] params ({}) + def create_configuration_manager(params = {}, options = {}) + req = build_request(:create_configuration_manager, params) + req.send_request(options) + end + + # Deletes a configuration manager. + # + # @option params [required, String] :manager_arn + # The ID of the configuration manager. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.delete_configuration_manager({ + # manager_arn: "DeleteConfigurationManagerInputManagerArnString", # required + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/DeleteConfigurationManager AWS API Documentation + # + # @overload delete_configuration_manager(params = {}) + # @param [Hash] params ({}) + def delete_configuration_manager(params = {}, options = {}) + req = build_request(:delete_configuration_manager, params) + req.send_request(options) + end + + # Returns a configuration manager. + # + # @option params [required, String] :manager_arn + # The ARN of the configuration manager. + # + # @return [Types::GetConfigurationManagerOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::GetConfigurationManagerOutput#configuration_definitions #configuration_definitions} => Array<Types::ConfigurationDefinition> + # * {Types::GetConfigurationManagerOutput#created_at #created_at} => Time + # * {Types::GetConfigurationManagerOutput#description #description} => String + # * {Types::GetConfigurationManagerOutput#last_modified_at #last_modified_at} => Time + # * {Types::GetConfigurationManagerOutput#manager_arn #manager_arn} => String + # * {Types::GetConfigurationManagerOutput#name #name} => String + # * {Types::GetConfigurationManagerOutput#status_summaries #status_summaries} => Array<Types::StatusSummary> + # * {Types::GetConfigurationManagerOutput#tags #tags} => Hash<String,String> + # + # @example Request syntax with placeholder values + # + # resp = client.get_configuration_manager({ + # manager_arn: "GetConfigurationManagerInputManagerArnString", # required + # }) + # + # @example Response structure + # + # resp.configuration_definitions #=> Array + # resp.configuration_definitions[0].id #=> String + # resp.configuration_definitions[0].local_deployment_administration_role_arn #=> String + # resp.configuration_definitions[0].local_deployment_execution_role_name #=> String + # resp.configuration_definitions[0].parameters #=> Hash + # resp.configuration_definitions[0].parameters["ConfigurationParametersMapKeyString"] #=> String + # resp.configuration_definitions[0].type #=> String + # resp.configuration_definitions[0].type_version #=> String + # resp.created_at #=> Time + # resp.description #=> String + # resp.last_modified_at #=> Time + # resp.manager_arn #=> String + # resp.name #=> String + # resp.status_summaries #=> Array + # resp.status_summaries[0].last_updated_at #=> Time + # resp.status_summaries[0].status #=> String, one of "INITIALIZING", "DEPLOYING", "SUCCEEDED", "DELETING", "STOPPING", "FAILED", "STOPPED", "DELETE_FAILED", "STOP_FAILED", "NONE" + # resp.status_summaries[0].status_details #=> Hash + # resp.status_summaries[0].status_details["String"] #=> String + # resp.status_summaries[0].status_message #=> String + # resp.status_summaries[0].status_type #=> String, one of "Deployment", "AsyncExecutions" + # resp.tags #=> Hash + # resp.tags["TagsMapKeyString"] #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/GetConfigurationManager AWS API Documentation + # + # @overload get_configuration_manager(params = {}) + # @param [Hash] params ({}) + def get_configuration_manager(params = {}, options = {}) + req = build_request(:get_configuration_manager, params) + req.send_request(options) + end + + # Returns settings configured for Quick Setup in the requesting Amazon + # Web Services account and Amazon Web Services Region. + # + # @return [Types::GetServiceSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::GetServiceSettingsOutput#service_settings #service_settings} => Types::ServiceSettings + # + # @example Response structure + # + # resp.service_settings.explorer_enabling_role_arn #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/GetServiceSettings AWS API Documentation + # + # @overload get_service_settings(params = {}) + # @param [Hash] params ({}) + def get_service_settings(params = {}, options = {}) + req = build_request(:get_service_settings, params) + req.send_request(options) + end + + # Returns Quick Setup configuration managers. + # + # @option params [Array] :filters + # Filters the results returned by the request. + # + # @option params [Integer] :max_items + # Specifies the maximum number of configuration managers that are + # returned by the request. + # + # @option params [String] :starting_token + # The token to use when requesting a specific set of items from a list. + # + # @return [Types::ListConfigurationManagersOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::ListConfigurationManagersOutput#configuration_managers_list #configuration_managers_list} => Array<Types::ConfigurationManagerSummary> + # * {Types::ListConfigurationManagersOutput#next_token #next_token} => String + # + # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. + # + # @example Request syntax with placeholder values + # + # resp = client.list_configuration_managers({ + # filters: [ + # { + # key: "FilterKeyString", # required + # values: ["FilterValuesMemberString"], # required + # }, + # ], + # max_items: 1, + # starting_token: "ListConfigurationManagersInputStartingTokenString", + # }) + # + # @example Response structure + # + # resp.configuration_managers_list #=> Array + # resp.configuration_managers_list[0].configuration_definition_summaries #=> Array + # resp.configuration_managers_list[0].configuration_definition_summaries[0].first_class_parameters #=> Hash + # resp.configuration_managers_list[0].configuration_definition_summaries[0].first_class_parameters["ConfigurationParametersMapKeyString"] #=> String + # resp.configuration_managers_list[0].configuration_definition_summaries[0].id #=> String + # resp.configuration_managers_list[0].configuration_definition_summaries[0].type #=> String + # resp.configuration_managers_list[0].configuration_definition_summaries[0].type_version #=> String + # resp.configuration_managers_list[0].description #=> String + # resp.configuration_managers_list[0].manager_arn #=> String + # resp.configuration_managers_list[0].name #=> String + # resp.configuration_managers_list[0].status_summaries #=> Array + # resp.configuration_managers_list[0].status_summaries[0].last_updated_at #=> Time + # resp.configuration_managers_list[0].status_summaries[0].status #=> String, one of "INITIALIZING", "DEPLOYING", "SUCCEEDED", "DELETING", "STOPPING", "FAILED", "STOPPED", "DELETE_FAILED", "STOP_FAILED", "NONE" + # resp.configuration_managers_list[0].status_summaries[0].status_details #=> Hash + # resp.configuration_managers_list[0].status_summaries[0].status_details["String"] #=> String + # resp.configuration_managers_list[0].status_summaries[0].status_message #=> String + # resp.configuration_managers_list[0].status_summaries[0].status_type #=> String, one of "Deployment", "AsyncExecutions" + # resp.next_token #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListConfigurationManagers AWS API Documentation + # + # @overload list_configuration_managers(params = {}) + # @param [Hash] params ({}) + def list_configuration_managers(params = {}, options = {}) + req = build_request(:list_configuration_managers, params) + req.send_request(options) + end + + # Returns the available Quick Setup types. + # + # @return [Types::ListQuickSetupTypesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::ListQuickSetupTypesOutput#quick_setup_type_list #quick_setup_type_list} => Array<Types::QuickSetupTypeOutput> + # + # @example Response structure + # + # resp.quick_setup_type_list #=> Array + # resp.quick_setup_type_list[0].latest_version #=> String + # resp.quick_setup_type_list[0].type #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListQuickSetupTypes AWS API Documentation + # + # @overload list_quick_setup_types(params = {}) + # @param [Hash] params ({}) + def list_quick_setup_types(params = {}, options = {}) + req = build_request(:list_quick_setup_types, params) + req.send_request(options) + end + + # Returns tags assigned to the resource. + # + # @option params [required, String] :resource_arn + # The ARN of the resource the tag is assigned to. + # + # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::ListTagsForResourceResponse#tags #tags} => Array<Types::TagEntry> + # + # @example Request syntax with placeholder values + # + # resp = client.list_tags_for_resource({ + # resource_arn: "String", # required + # }) + # + # @example Response structure + # + # resp.tags #=> Array + # resp.tags[0].key #=> String + # resp.tags[0].value #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListTagsForResource AWS API Documentation + # + # @overload list_tags_for_resource(params = {}) + # @param [Hash] params ({}) + def list_tags_for_resource(params = {}, options = {}) + req = build_request(:list_tags_for_resource, params) + req.send_request(options) + end + + # Assigns key-value pairs of metadata to Amazon Web Services resources. + # + # @option params [required, String] :resource_arn + # The ARN of the resource to tag. + # + # @option params [required, Hash] :tags + # Key-value pairs of metadata to assign to the resource. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.tag_resource({ + # resource_arn: "String", # required + # tags: { # required + # "TagsMapKeyString" => "TagsMapValueString", + # }, + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/TagResource AWS API Documentation + # + # @overload tag_resource(params = {}) + # @param [Hash] params ({}) + def tag_resource(params = {}, options = {}) + req = build_request(:tag_resource, params) + req.send_request(options) + end + + # Removes tags from the specified resource. + # + # @option params [required, String] :resource_arn + # The ARN of the resource to remove tags from. + # + # @option params [required, Array] :tag_keys + # The keys of the tags to remove from the resource. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.untag_resource({ + # resource_arn: "String", # required + # tag_keys: ["String"], # required + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UntagResource AWS API Documentation + # + # @overload untag_resource(params = {}) + # @param [Hash] params ({}) + def untag_resource(params = {}, options = {}) + req = build_request(:untag_resource, params) + req.send_request(options) + end + + # Updates a Quick Setup configuration definition. + # + # @option params [required, String] :id + # The ID of the configuration definition you want to update. + # + # @option params [String] :local_deployment_administration_role_arn + # The ARN of the IAM role used to administrate local configuration + # deployments. + # + # @option params [String] :local_deployment_execution_role_name + # The name of the IAM role used to deploy local configurations. + # + # @option params [required, String] :manager_arn + # The ARN of the configuration manager associated with the definition to + # update. + # + # @option params [Hash] :parameters + # The parameters for the configuration definition type. + # + # @option params [String] :type_version + # The version of the Quick Setup type to use. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.update_configuration_definition({ + # id: "UpdateConfigurationDefinitionInputIdString", # required + # local_deployment_administration_role_arn: "IAMRoleArn", + # local_deployment_execution_role_name: "UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString", + # manager_arn: "UpdateConfigurationDefinitionInputManagerArnString", # required + # parameters: { + # "ConfigurationParametersMapKeyString" => "ConfigurationParametersMapValueString", + # }, + # type_version: "UpdateConfigurationDefinitionInputTypeVersionString", + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UpdateConfigurationDefinition AWS API Documentation + # + # @overload update_configuration_definition(params = {}) + # @param [Hash] params ({}) + def update_configuration_definition(params = {}, options = {}) + req = build_request(:update_configuration_definition, params) + req.send_request(options) + end + + # Updates a Quick Setup configuration manager. + # + # @option params [String] :description + # A description of the configuration manager. + # + # @option params [required, String] :manager_arn + # The ARN of the configuration manager. + # + # @option params [String] :name + # A name for the configuration manager. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.update_configuration_manager({ + # description: "UpdateConfigurationManagerInputDescriptionString", + # manager_arn: "UpdateConfigurationManagerInputManagerArnString", # required + # name: "UpdateConfigurationManagerInputNameString", + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UpdateConfigurationManager AWS API Documentation + # + # @overload update_configuration_manager(params = {}) + # @param [Hash] params ({}) + def update_configuration_manager(params = {}, options = {}) + req = build_request(:update_configuration_manager, params) + req.send_request(options) + end + + # Updates settings configured for Quick Setup. + # + # @option params [String] :explorer_enabling_role_arn + # The IAM role used to enable Explorer. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.update_service_settings({ + # explorer_enabling_role_arn: "IAMRoleArn", + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UpdateServiceSettings AWS API Documentation + # + # @overload update_service_settings(params = {}) + # @param [Hash] params ({}) + def update_service_settings(params = {}, options = {}) + req = build_request(:update_service_settings, params) + req.send_request(options) + end + + # @!endgroup + + # @param params ({}) + # @api private + def build_request(operation_name, params = {}) + handlers = @handlers.for(operation_name) + context = Seahorse::Client::RequestContext.new( + operation_name: operation_name, + operation: config.api.operation(operation_name), + client: self, + params: params, + config: config) + context[:gem_name] = 'aws-sdk-ssmquicksetup' + context[:gem_version] = '1.0.0' + Seahorse::Client::Request.new(handlers, context) + end + + # @api private + # @deprecated + def waiter_names + [] + end + + class << self + + # @api private + attr_reader :identifier + + # @api private + def errors_module + Errors + end + + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/client_api.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/client_api.rb new file mode 100644 index 00000000000..d0eab4f1f07 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/client_api.rb @@ -0,0 +1,449 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws::SSMQuickSetup + # @api private + module ClientApi + + include Seahorse::Model + + AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException') + ConfigurationDefinition = Shapes::StructureShape.new(name: 'ConfigurationDefinition') + ConfigurationDefinitionInput = Shapes::StructureShape.new(name: 'ConfigurationDefinitionInput') + ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString = Shapes::StringShape.new(name: 'ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString') + ConfigurationDefinitionInputTypeString = Shapes::StringShape.new(name: 'ConfigurationDefinitionInputTypeString') + ConfigurationDefinitionInputTypeVersionString = Shapes::StringShape.new(name: 'ConfigurationDefinitionInputTypeVersionString') + ConfigurationDefinitionLocalDeploymentExecutionRoleNameString = Shapes::StringShape.new(name: 'ConfigurationDefinitionLocalDeploymentExecutionRoleNameString') + ConfigurationDefinitionSummariesList = Shapes::ListShape.new(name: 'ConfigurationDefinitionSummariesList') + ConfigurationDefinitionSummary = Shapes::StructureShape.new(name: 'ConfigurationDefinitionSummary') + ConfigurationDefinitionTypeString = Shapes::StringShape.new(name: 'ConfigurationDefinitionTypeString') + ConfigurationDefinitionTypeVersionString = Shapes::StringShape.new(name: 'ConfigurationDefinitionTypeVersionString') + ConfigurationDefinitionsInputList = Shapes::ListShape.new(name: 'ConfigurationDefinitionsInputList') + ConfigurationDefinitionsList = Shapes::ListShape.new(name: 'ConfigurationDefinitionsList') + ConfigurationManagerList = Shapes::ListShape.new(name: 'ConfigurationManagerList') + ConfigurationManagerSummary = Shapes::StructureShape.new(name: 'ConfigurationManagerSummary') + ConfigurationParametersMap = Shapes::MapShape.new(name: 'ConfigurationParametersMap') + ConfigurationParametersMapKeyString = Shapes::StringShape.new(name: 'ConfigurationParametersMapKeyString') + ConfigurationParametersMapValueString = Shapes::StringShape.new(name: 'ConfigurationParametersMapValueString') + ConflictException = Shapes::StructureShape.new(name: 'ConflictException') + CreateConfigurationManagerInput = Shapes::StructureShape.new(name: 'CreateConfigurationManagerInput') + CreateConfigurationManagerInputDescriptionString = Shapes::StringShape.new(name: 'CreateConfigurationManagerInputDescriptionString') + CreateConfigurationManagerInputNameString = Shapes::StringShape.new(name: 'CreateConfigurationManagerInputNameString') + CreateConfigurationManagerOutput = Shapes::StructureShape.new(name: 'CreateConfigurationManagerOutput') + DeleteConfigurationManagerInput = Shapes::StructureShape.new(name: 'DeleteConfigurationManagerInput') + DeleteConfigurationManagerInputManagerArnString = Shapes::StringShape.new(name: 'DeleteConfigurationManagerInputManagerArnString') + Filter = Shapes::StructureShape.new(name: 'Filter') + FilterKeyString = Shapes::StringShape.new(name: 'FilterKeyString') + FilterValues = Shapes::ListShape.new(name: 'FilterValues') + FilterValuesMemberString = Shapes::StringShape.new(name: 'FilterValuesMemberString') + FiltersList = Shapes::ListShape.new(name: 'FiltersList') + GetConfigurationManagerInput = Shapes::StructureShape.new(name: 'GetConfigurationManagerInput') + GetConfigurationManagerInputManagerArnString = Shapes::StringShape.new(name: 'GetConfigurationManagerInputManagerArnString') + GetConfigurationManagerOutput = Shapes::StructureShape.new(name: 'GetConfigurationManagerOutput') + GetServiceSettingsOutput = Shapes::StructureShape.new(name: 'GetServiceSettingsOutput') + IAMRoleArn = Shapes::StringShape.new(name: 'IAMRoleArn') + InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException') + ListConfigurationManagersInput = Shapes::StructureShape.new(name: 'ListConfigurationManagersInput') + ListConfigurationManagersInputMaxItemsInteger = Shapes::IntegerShape.new(name: 'ListConfigurationManagersInputMaxItemsInteger') + ListConfigurationManagersInputStartingTokenString = Shapes::StringShape.new(name: 'ListConfigurationManagersInputStartingTokenString') + ListConfigurationManagersOutput = Shapes::StructureShape.new(name: 'ListConfigurationManagersOutput') + ListQuickSetupTypesOutput = Shapes::StructureShape.new(name: 'ListQuickSetupTypesOutput') + ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest') + ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse') + QuickSetupTypeList = Shapes::ListShape.new(name: 'QuickSetupTypeList') + QuickSetupTypeOutput = Shapes::StructureShape.new(name: 'QuickSetupTypeOutput') + ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException') + ServiceSettings = Shapes::StructureShape.new(name: 'ServiceSettings') + Status = Shapes::StringShape.new(name: 'Status') + StatusDetails = Shapes::MapShape.new(name: 'StatusDetails') + StatusSummariesList = Shapes::ListShape.new(name: 'StatusSummariesList') + StatusSummary = Shapes::StructureShape.new(name: 'StatusSummary') + StatusType = Shapes::StringShape.new(name: 'StatusType') + String = Shapes::StringShape.new(name: 'String') + SyntheticTimestamp_date_time = Shapes::TimestampShape.new(name: 'SyntheticTimestamp_date_time', timestampFormat: "iso8601") + TagEntry = Shapes::StructureShape.new(name: 'TagEntry') + TagEntryKeyString = Shapes::StringShape.new(name: 'TagEntryKeyString') + TagEntryValueString = Shapes::StringShape.new(name: 'TagEntryValueString') + TagKeys = Shapes::ListShape.new(name: 'TagKeys') + TagResourceInput = Shapes::StructureShape.new(name: 'TagResourceInput') + Tags = Shapes::ListShape.new(name: 'Tags') + TagsMap = Shapes::MapShape.new(name: 'TagsMap') + TagsMapKeyString = Shapes::StringShape.new(name: 'TagsMapKeyString') + TagsMapValueString = Shapes::StringShape.new(name: 'TagsMapValueString') + ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException') + UntagResourceInput = Shapes::StructureShape.new(name: 'UntagResourceInput') + UpdateConfigurationDefinitionInput = Shapes::StructureShape.new(name: 'UpdateConfigurationDefinitionInput') + UpdateConfigurationDefinitionInputIdString = Shapes::StringShape.new(name: 'UpdateConfigurationDefinitionInputIdString') + UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString = Shapes::StringShape.new(name: 'UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString') + UpdateConfigurationDefinitionInputManagerArnString = Shapes::StringShape.new(name: 'UpdateConfigurationDefinitionInputManagerArnString') + UpdateConfigurationDefinitionInputTypeVersionString = Shapes::StringShape.new(name: 'UpdateConfigurationDefinitionInputTypeVersionString') + UpdateConfigurationManagerInput = Shapes::StructureShape.new(name: 'UpdateConfigurationManagerInput') + UpdateConfigurationManagerInputDescriptionString = Shapes::StringShape.new(name: 'UpdateConfigurationManagerInputDescriptionString') + UpdateConfigurationManagerInputManagerArnString = Shapes::StringShape.new(name: 'UpdateConfigurationManagerInputManagerArnString') + UpdateConfigurationManagerInputNameString = Shapes::StringShape.new(name: 'UpdateConfigurationManagerInputNameString') + UpdateServiceSettingsInput = Shapes::StructureShape.new(name: 'UpdateServiceSettingsInput') + ValidationException = Shapes::StructureShape.new(name: 'ValidationException') + + AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) + AccessDeniedException.struct_class = Types::AccessDeniedException + + ConfigurationDefinition.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "Id")) + ConfigurationDefinition.add_member(:local_deployment_administration_role_arn, Shapes::ShapeRef.new(shape: IAMRoleArn, location_name: "LocalDeploymentAdministrationRoleArn")) + ConfigurationDefinition.add_member(:local_deployment_execution_role_name, Shapes::ShapeRef.new(shape: ConfigurationDefinitionLocalDeploymentExecutionRoleNameString, location_name: "LocalDeploymentExecutionRoleName")) + ConfigurationDefinition.add_member(:parameters, Shapes::ShapeRef.new(shape: ConfigurationParametersMap, required: true, location_name: "Parameters")) + ConfigurationDefinition.add_member(:type, Shapes::ShapeRef.new(shape: ConfigurationDefinitionTypeString, required: true, location_name: "Type")) + ConfigurationDefinition.add_member(:type_version, Shapes::ShapeRef.new(shape: ConfigurationDefinitionTypeVersionString, location_name: "TypeVersion")) + ConfigurationDefinition.struct_class = Types::ConfigurationDefinition + + ConfigurationDefinitionInput.add_member(:local_deployment_administration_role_arn, Shapes::ShapeRef.new(shape: IAMRoleArn, location_name: "LocalDeploymentAdministrationRoleArn")) + ConfigurationDefinitionInput.add_member(:local_deployment_execution_role_name, Shapes::ShapeRef.new(shape: ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString, location_name: "LocalDeploymentExecutionRoleName")) + ConfigurationDefinitionInput.add_member(:parameters, Shapes::ShapeRef.new(shape: ConfigurationParametersMap, required: true, location_name: "Parameters")) + ConfigurationDefinitionInput.add_member(:type, Shapes::ShapeRef.new(shape: ConfigurationDefinitionInputTypeString, required: true, location_name: "Type")) + ConfigurationDefinitionInput.add_member(:type_version, Shapes::ShapeRef.new(shape: ConfigurationDefinitionInputTypeVersionString, location_name: "TypeVersion")) + ConfigurationDefinitionInput.struct_class = Types::ConfigurationDefinitionInput + + ConfigurationDefinitionSummariesList.member = Shapes::ShapeRef.new(shape: ConfigurationDefinitionSummary) + + ConfigurationDefinitionSummary.add_member(:first_class_parameters, Shapes::ShapeRef.new(shape: ConfigurationParametersMap, location_name: "FirstClassParameters")) + ConfigurationDefinitionSummary.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "Id")) + ConfigurationDefinitionSummary.add_member(:type, Shapes::ShapeRef.new(shape: String, location_name: "Type")) + ConfigurationDefinitionSummary.add_member(:type_version, Shapes::ShapeRef.new(shape: String, location_name: "TypeVersion")) + ConfigurationDefinitionSummary.struct_class = Types::ConfigurationDefinitionSummary + + ConfigurationDefinitionsInputList.member = Shapes::ShapeRef.new(shape: ConfigurationDefinitionInput) + + ConfigurationDefinitionsList.member = Shapes::ShapeRef.new(shape: ConfigurationDefinition) + + ConfigurationManagerList.member = Shapes::ShapeRef.new(shape: ConfigurationManagerSummary) + + ConfigurationManagerSummary.add_member(:configuration_definition_summaries, Shapes::ShapeRef.new(shape: ConfigurationDefinitionSummariesList, location_name: "ConfigurationDefinitionSummaries")) + ConfigurationManagerSummary.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "Description")) + ConfigurationManagerSummary.add_member(:manager_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ManagerArn")) + ConfigurationManagerSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name")) + ConfigurationManagerSummary.add_member(:status_summaries, Shapes::ShapeRef.new(shape: StatusSummariesList, location_name: "StatusSummaries")) + ConfigurationManagerSummary.struct_class = Types::ConfigurationManagerSummary + + ConfigurationParametersMap.key = Shapes::ShapeRef.new(shape: ConfigurationParametersMapKeyString) + ConfigurationParametersMap.value = Shapes::ShapeRef.new(shape: ConfigurationParametersMapValueString) + + ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) + ConflictException.struct_class = Types::ConflictException + + CreateConfigurationManagerInput.add_member(:configuration_definitions, Shapes::ShapeRef.new(shape: ConfigurationDefinitionsInputList, required: true, location_name: "ConfigurationDefinitions")) + CreateConfigurationManagerInput.add_member(:description, Shapes::ShapeRef.new(shape: CreateConfigurationManagerInputDescriptionString, location_name: "Description")) + CreateConfigurationManagerInput.add_member(:name, Shapes::ShapeRef.new(shape: CreateConfigurationManagerInputNameString, location_name: "Name")) + CreateConfigurationManagerInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagsMap, location_name: "Tags")) + CreateConfigurationManagerInput.struct_class = Types::CreateConfigurationManagerInput + + CreateConfigurationManagerOutput.add_member(:manager_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ManagerArn")) + CreateConfigurationManagerOutput.struct_class = Types::CreateConfigurationManagerOutput + + DeleteConfigurationManagerInput.add_member(:manager_arn, Shapes::ShapeRef.new(shape: DeleteConfigurationManagerInputManagerArnString, required: true, location: "uri", location_name: "ManagerArn")) + DeleteConfigurationManagerInput.struct_class = Types::DeleteConfigurationManagerInput + + Filter.add_member(:key, Shapes::ShapeRef.new(shape: FilterKeyString, required: true, location_name: "Key")) + Filter.add_member(:values, Shapes::ShapeRef.new(shape: FilterValues, required: true, location_name: "Values")) + Filter.struct_class = Types::Filter + + FilterValues.member = Shapes::ShapeRef.new(shape: FilterValuesMemberString) + + FiltersList.member = Shapes::ShapeRef.new(shape: Filter) + + GetConfigurationManagerInput.add_member(:manager_arn, Shapes::ShapeRef.new(shape: GetConfigurationManagerInputManagerArnString, required: true, location: "uri", location_name: "ManagerArn")) + GetConfigurationManagerInput.struct_class = Types::GetConfigurationManagerInput + + GetConfigurationManagerOutput.add_member(:configuration_definitions, Shapes::ShapeRef.new(shape: ConfigurationDefinitionsList, location_name: "ConfigurationDefinitions")) + GetConfigurationManagerOutput.add_member(:created_at, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, location_name: "CreatedAt")) + GetConfigurationManagerOutput.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "Description")) + GetConfigurationManagerOutput.add_member(:last_modified_at, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, location_name: "LastModifiedAt")) + GetConfigurationManagerOutput.add_member(:manager_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ManagerArn")) + GetConfigurationManagerOutput.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name")) + GetConfigurationManagerOutput.add_member(:status_summaries, Shapes::ShapeRef.new(shape: StatusSummariesList, location_name: "StatusSummaries")) + GetConfigurationManagerOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagsMap, location_name: "Tags")) + GetConfigurationManagerOutput.struct_class = Types::GetConfigurationManagerOutput + + GetServiceSettingsOutput.add_member(:service_settings, Shapes::ShapeRef.new(shape: ServiceSettings, location_name: "ServiceSettings")) + GetServiceSettingsOutput.struct_class = Types::GetServiceSettingsOutput + + InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) + InternalServerException.struct_class = Types::InternalServerException + + ListConfigurationManagersInput.add_member(:filters, Shapes::ShapeRef.new(shape: FiltersList, location_name: "Filters")) + ListConfigurationManagersInput.add_member(:max_items, Shapes::ShapeRef.new(shape: ListConfigurationManagersInputMaxItemsInteger, location_name: "MaxItems")) + ListConfigurationManagersInput.add_member(:starting_token, Shapes::ShapeRef.new(shape: ListConfigurationManagersInputStartingTokenString, location_name: "StartingToken")) + ListConfigurationManagersInput.struct_class = Types::ListConfigurationManagersInput + + ListConfigurationManagersOutput.add_member(:configuration_managers_list, Shapes::ShapeRef.new(shape: ConfigurationManagerList, location_name: "ConfigurationManagersList")) + ListConfigurationManagersOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken")) + ListConfigurationManagersOutput.struct_class = Types::ListConfigurationManagersOutput + + ListQuickSetupTypesOutput.add_member(:quick_setup_type_list, Shapes::ShapeRef.new(shape: QuickSetupTypeList, location_name: "QuickSetupTypeList")) + ListQuickSetupTypesOutput.struct_class = Types::ListQuickSetupTypesOutput + + ListTagsForResourceRequest.add_member(:resource_arn, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "ResourceArn")) + ListTagsForResourceRequest.struct_class = Types::ListTagsForResourceRequest + + ListTagsForResourceResponse.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags")) + ListTagsForResourceResponse.struct_class = Types::ListTagsForResourceResponse + + QuickSetupTypeList.member = Shapes::ShapeRef.new(shape: QuickSetupTypeOutput) + + QuickSetupTypeOutput.add_member(:latest_version, Shapes::ShapeRef.new(shape: String, location_name: "LatestVersion")) + QuickSetupTypeOutput.add_member(:type, Shapes::ShapeRef.new(shape: String, location_name: "Type")) + QuickSetupTypeOutput.struct_class = Types::QuickSetupTypeOutput + + ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) + ResourceNotFoundException.struct_class = Types::ResourceNotFoundException + + ServiceSettings.add_member(:explorer_enabling_role_arn, Shapes::ShapeRef.new(shape: IAMRoleArn, location_name: "ExplorerEnablingRoleArn")) + ServiceSettings.struct_class = Types::ServiceSettings + + StatusDetails.key = Shapes::ShapeRef.new(shape: String) + StatusDetails.value = Shapes::ShapeRef.new(shape: String) + + StatusSummariesList.member = Shapes::ShapeRef.new(shape: StatusSummary) + + StatusSummary.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, required: true, location_name: "LastUpdatedAt")) + StatusSummary.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "Status")) + StatusSummary.add_member(:status_details, Shapes::ShapeRef.new(shape: StatusDetails, location_name: "StatusDetails")) + StatusSummary.add_member(:status_message, Shapes::ShapeRef.new(shape: String, location_name: "StatusMessage")) + StatusSummary.add_member(:status_type, Shapes::ShapeRef.new(shape: StatusType, required: true, location_name: "StatusType")) + StatusSummary.struct_class = Types::StatusSummary + + TagEntry.add_member(:key, Shapes::ShapeRef.new(shape: TagEntryKeyString, location_name: "Key")) + TagEntry.add_member(:value, Shapes::ShapeRef.new(shape: TagEntryValueString, location_name: "Value")) + TagEntry.struct_class = Types::TagEntry + + TagKeys.member = Shapes::ShapeRef.new(shape: String) + + TagResourceInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "ResourceArn")) + TagResourceInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagsMap, required: true, location_name: "Tags")) + TagResourceInput.struct_class = Types::TagResourceInput + + Tags.member = Shapes::ShapeRef.new(shape: TagEntry) + + TagsMap.key = Shapes::ShapeRef.new(shape: TagsMapKeyString) + TagsMap.value = Shapes::ShapeRef.new(shape: TagsMapValueString) + + ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Message")) + ThrottlingException.struct_class = Types::ThrottlingException + + UntagResourceInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "ResourceArn")) + UntagResourceInput.add_member(:tag_keys, Shapes::ShapeRef.new(shape: TagKeys, required: true, location: "querystring", location_name: "tagKeys")) + UntagResourceInput.struct_class = Types::UntagResourceInput + + UpdateConfigurationDefinitionInput.add_member(:id, Shapes::ShapeRef.new(shape: UpdateConfigurationDefinitionInputIdString, required: true, location: "uri", location_name: "Id")) + UpdateConfigurationDefinitionInput.add_member(:local_deployment_administration_role_arn, Shapes::ShapeRef.new(shape: IAMRoleArn, location_name: "LocalDeploymentAdministrationRoleArn")) + UpdateConfigurationDefinitionInput.add_member(:local_deployment_execution_role_name, Shapes::ShapeRef.new(shape: UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString, location_name: "LocalDeploymentExecutionRoleName")) + UpdateConfigurationDefinitionInput.add_member(:manager_arn, Shapes::ShapeRef.new(shape: UpdateConfigurationDefinitionInputManagerArnString, required: true, location: "uri", location_name: "ManagerArn")) + UpdateConfigurationDefinitionInput.add_member(:parameters, Shapes::ShapeRef.new(shape: ConfigurationParametersMap, location_name: "Parameters")) + UpdateConfigurationDefinitionInput.add_member(:type_version, Shapes::ShapeRef.new(shape: UpdateConfigurationDefinitionInputTypeVersionString, location_name: "TypeVersion")) + UpdateConfigurationDefinitionInput.struct_class = Types::UpdateConfigurationDefinitionInput + + UpdateConfigurationManagerInput.add_member(:description, Shapes::ShapeRef.new(shape: UpdateConfigurationManagerInputDescriptionString, location_name: "Description")) + UpdateConfigurationManagerInput.add_member(:manager_arn, Shapes::ShapeRef.new(shape: UpdateConfigurationManagerInputManagerArnString, required: true, location: "uri", location_name: "ManagerArn")) + UpdateConfigurationManagerInput.add_member(:name, Shapes::ShapeRef.new(shape: UpdateConfigurationManagerInputNameString, location_name: "Name")) + UpdateConfigurationManagerInput.struct_class = Types::UpdateConfigurationManagerInput + + UpdateServiceSettingsInput.add_member(:explorer_enabling_role_arn, Shapes::ShapeRef.new(shape: IAMRoleArn, location_name: "ExplorerEnablingRoleArn")) + UpdateServiceSettingsInput.struct_class = Types::UpdateServiceSettingsInput + + ValidationException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message")) + ValidationException.struct_class = Types::ValidationException + + + # @api private + API = Seahorse::Model::Api.new.tap do |api| + + api.version = "2018-05-10" + + api.metadata = { + "apiVersion" => "2018-05-10", + "auth" => ["aws.auth#sigv4"], + "endpointPrefix" => "ssm-quicksetup", + "jsonVersion" => "1.1", + "protocol" => "rest-json", + "protocols" => ["rest-json"], + "serviceFullName" => "AWS Systems Manager QuickSetup", + "serviceId" => "SSM QuickSetup", + "signatureVersion" => "v4", + "signingName" => "ssm-quicksetup", + "uid" => "ssm-quicksetup-2018-05-10", + } + + api.add_operation(:create_configuration_manager, Seahorse::Model::Operation.new.tap do |o| + o.name = "CreateConfigurationManager" + o.http_method = "POST" + o.http_request_uri = "/configurationManager" + o.input = Shapes::ShapeRef.new(shape: CreateConfigurationManagerInput) + o.output = Shapes::ShapeRef.new(shape: CreateConfigurationManagerOutput) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + + api.add_operation(:delete_configuration_manager, Seahorse::Model::Operation.new.tap do |o| + o.name = "DeleteConfigurationManager" + o.http_method = "DELETE" + o.http_request_uri = "/configurationManager/{ManagerArn}" + o.input = Shapes::ShapeRef.new(shape: DeleteConfigurationManagerInput) + o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + end) + + api.add_operation(:get_configuration_manager, Seahorse::Model::Operation.new.tap do |o| + o.name = "GetConfigurationManager" + o.http_method = "GET" + o.http_request_uri = "/configurationManager/{ManagerArn}" + o.input = Shapes::ShapeRef.new(shape: GetConfigurationManagerInput) + o.output = Shapes::ShapeRef.new(shape: GetConfigurationManagerOutput) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + end) + + api.add_operation(:get_service_settings, Seahorse::Model::Operation.new.tap do |o| + o.name = "GetServiceSettings" + o.http_method = "GET" + o.http_request_uri = "/serviceSettings" + o.input = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.output = Shapes::ShapeRef.new(shape: GetServiceSettingsOutput) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + + api.add_operation(:list_configuration_managers, Seahorse::Model::Operation.new.tap do |o| + o.name = "ListConfigurationManagers" + o.http_method = "POST" + o.http_request_uri = "/listConfigurationManagers" + o.input = Shapes::ShapeRef.new(shape: ListConfigurationManagersInput) + o.output = Shapes::ShapeRef.new(shape: ListConfigurationManagersOutput) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o[:pager] = Aws::Pager.new( + limit_key: "max_items", + tokens: { + "next_token" => "starting_token" + } + ) + end) + + api.add_operation(:list_quick_setup_types, Seahorse::Model::Operation.new.tap do |o| + o.name = "ListQuickSetupTypes" + o.http_method = "GET" + o.http_request_uri = "/listQuickSetupTypes" + o.input = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.output = Shapes::ShapeRef.new(shape: ListQuickSetupTypesOutput) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + + api.add_operation(:list_tags_for_resource, Seahorse::Model::Operation.new.tap do |o| + o.name = "ListTagsForResource" + o.http_method = "GET" + o.http_request_uri = "/tags/{ResourceArn}" + o.input = Shapes::ShapeRef.new(shape: ListTagsForResourceRequest) + o.output = Shapes::ShapeRef.new(shape: ListTagsForResourceResponse) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + end) + + api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o| + o.name = "TagResource" + o.http_method = "PUT" + o.http_request_uri = "/tags/{ResourceArn}" + o.input = Shapes::ShapeRef.new(shape: TagResourceInput) + o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + end) + + api.add_operation(:untag_resource, Seahorse::Model::Operation.new.tap do |o| + o.name = "UntagResource" + o.http_method = "DELETE" + o.http_request_uri = "/tags/{ResourceArn}" + o.input = Shapes::ShapeRef.new(shape: UntagResourceInput) + o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + end) + + api.add_operation(:update_configuration_definition, Seahorse::Model::Operation.new.tap do |o| + o.name = "UpdateConfigurationDefinition" + o.http_method = "PUT" + o.http_request_uri = "/configurationDefinition/{ManagerArn}/{Id}" + o.input = Shapes::ShapeRef.new(shape: UpdateConfigurationDefinitionInput) + o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + end) + + api.add_operation(:update_configuration_manager, Seahorse::Model::Operation.new.tap do |o| + o.name = "UpdateConfigurationManager" + o.http_method = "PUT" + o.http_request_uri = "/configurationManager/{ManagerArn}" + o.input = Shapes::ShapeRef.new(shape: UpdateConfigurationManagerInput) + o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + end) + + api.add_operation(:update_service_settings, Seahorse::Model::Operation.new.tap do |o| + o.name = "UpdateServiceSettings" + o.http_method = "PUT" + o.http_request_uri = "/serviceSettings" + o.input = Shapes::ShapeRef.new(shape: UpdateServiceSettingsInput) + o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + end + + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/customizations.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/customizations.rb new file mode 100644 index 00000000000..e69de29bb2d diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoint_parameters.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoint_parameters.rb new file mode 100644 index 00000000000..cbbe3f5fc73 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoint_parameters.rb @@ -0,0 +1,66 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws::SSMQuickSetup + # Endpoint parameters used to influence endpoints per request. + # + # @!attribute region + # The AWS region used to dispatch the request. + # + # @return [String] + # + # @!attribute use_dual_stack + # When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error. + # + # @return [Boolean] + # + # @!attribute use_fips + # When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error. + # + # @return [Boolean] + # + # @!attribute endpoint + # Override the endpoint used to send this request + # + # @return [String] + # + EndpointParameters = Struct.new( + :region, + :use_dual_stack, + :use_fips, + :endpoint, + ) do + include Aws::Structure + + # @api private + class << self + PARAM_MAP = { + 'Region' => :region, + 'UseDualStack' => :use_dual_stack, + 'UseFIPS' => :use_fips, + 'Endpoint' => :endpoint, + }.freeze + end + + def initialize(options = {}) + self[:region] = options[:region] + self[:use_dual_stack] = options[:use_dual_stack] + self[:use_dual_stack] = false if self[:use_dual_stack].nil? + if self[:use_dual_stack].nil? + raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack" + end + self[:use_fips] = options[:use_fips] + self[:use_fips] = false if self[:use_fips].nil? + if self[:use_fips].nil? + raise ArgumentError, "Missing required EndpointParameter: :use_fips" + end + self[:endpoint] = options[:endpoint] + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoint_provider.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoint_provider.rb new file mode 100644 index 00000000000..62eecc2811f --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoint_provider.rb @@ -0,0 +1,54 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws::SSMQuickSetup + class EndpointProvider + def resolve_endpoint(parameters) + region = parameters.region + use_dual_stack = parameters.use_dual_stack + use_fips = parameters.use_fips + endpoint = parameters.endpoint + if Aws::Endpoints::Matchers.set?(endpoint) + if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) + raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported" + end + if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true) + raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported" + end + return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {}) + end + if Aws::Endpoints::Matchers.set?(region) + if (partition_result = Aws::Endpoints::Matchers.aws_partition(region)) + if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true) + if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack")) + return Aws::Endpoints::Endpoint.new(url: "https://ssm-quicksetup-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {}) + end + raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both" + end + if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) + if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true) + return Aws::Endpoints::Endpoint.new(url: "https://ssm-quicksetup-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {}) + end + raise ArgumentError, "FIPS is enabled but this partition does not support FIPS" + end + if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true) + if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack")) + return Aws::Endpoints::Endpoint.new(url: "https://ssm-quicksetup.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {}) + end + raise ArgumentError, "DualStack is enabled but this partition does not support DualStack" + end + return Aws::Endpoints::Endpoint.new(url: "https://ssm-quicksetup.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {}) + end + end + raise ArgumentError, "Invalid Configuration: Missing Region" + raise ArgumentError, 'No endpoint could be resolved' + + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoints.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoints.rb new file mode 100644 index 00000000000..b434f499a42 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/endpoints.rb @@ -0,0 +1,184 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + + +module Aws::SSMQuickSetup + # @api private + module Endpoints + + class CreateConfigurationManager + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class DeleteConfigurationManager + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class GetConfigurationManager + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class GetServiceSettings + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class ListConfigurationManagers + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class ListQuickSetupTypes + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class ListTagsForResource + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class TagResource + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class UntagResource + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class UpdateConfigurationDefinition + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class UpdateConfigurationManager + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + class UpdateServiceSettings + def self.build(context) + unless context.config.regional_endpoint + endpoint = context.config.endpoint.to_s + end + Aws::SSMQuickSetup::EndpointParameters.new( + region: context.config.region, + use_dual_stack: context.config.use_dualstack_endpoint, + use_fips: context.config.use_fips_endpoint, + endpoint: endpoint, + ) + end + end + + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/errors.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/errors.rb new file mode 100644 index 00000000000..583b7d62f23 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/errors.rb @@ -0,0 +1,142 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws::SSMQuickSetup + + # When SSMQuickSetup returns an error response, the Ruby SDK constructs and raises an error. + # These errors all extend Aws::SSMQuickSetup::Errors::ServiceError < {Aws::Errors::ServiceError} + # + # You can rescue all SSMQuickSetup errors using ServiceError: + # + # begin + # # do stuff + # rescue Aws::SSMQuickSetup::Errors::ServiceError + # # rescues all SSMQuickSetup API errors + # end + # + # + # ## Request Context + # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns + # information about the request that generated the error. + # See {Seahorse::Client::RequestContext} for more information. + # + # ## Error Classes + # * {AccessDeniedException} + # * {ConflictException} + # * {InternalServerException} + # * {ResourceNotFoundException} + # * {ThrottlingException} + # * {ValidationException} + # + # Additionally, error classes are dynamically generated for service errors based on the error code + # if they are not defined above. + module Errors + + extend Aws::Errors::DynamicErrors + + class AccessDeniedException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::SSMQuickSetup::Types::AccessDeniedException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + end + + class ConflictException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::SSMQuickSetup::Types::ConflictException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + end + + class InternalServerException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::SSMQuickSetup::Types::InternalServerException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + + def retryable? + true + end + end + + class ResourceNotFoundException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::SSMQuickSetup::Types::ResourceNotFoundException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + end + + class ThrottlingException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::SSMQuickSetup::Types::ThrottlingException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + + def retryable? + true + end + end + + class ValidationException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::SSMQuickSetup::Types::ValidationException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + end + + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/plugins/endpoints.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/plugins/endpoints.rb new file mode 100644 index 00000000000..4310ec162e0 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/plugins/endpoints.rb @@ -0,0 +1,94 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + + +module Aws::SSMQuickSetup + module Plugins + class Endpoints < Seahorse::Client::Plugin + option( + :endpoint_provider, + doc_type: 'Aws::SSMQuickSetup::EndpointProvider', + rbs_type: 'untyped', + docstring: 'The endpoint provider used to resolve endpoints. Any '\ + 'object that responds to `#resolve_endpoint(parameters)` '\ + 'where `parameters` is a Struct similar to '\ + '`Aws::SSMQuickSetup::EndpointParameters`' + ) do |cfg| + Aws::SSMQuickSetup::EndpointProvider.new + end + + # @api private + class Handler < Seahorse::Client::Handler + def call(context) + unless context[:discovered_endpoint] + params = parameters_for_operation(context) + endpoint = context.config.endpoint_provider.resolve_endpoint(params) + + context.http_request.endpoint = endpoint.url + apply_endpoint_headers(context, endpoint.headers) + + context[:endpoint_params] = params + context[:endpoint_properties] = endpoint.properties + end + + context[:auth_scheme] = + Aws::Endpoints.resolve_auth_scheme(context, endpoint) + + @handler.call(context) + end + + private + + def apply_endpoint_headers(context, headers) + headers.each do |key, values| + value = values + .compact + .map { |s| Seahorse::Util.escape_header_list_string(s.to_s) } + .join(',') + + context.http_request.headers[key] = value + end + end + + def parameters_for_operation(context) + case context.operation_name + when :create_configuration_manager + Aws::SSMQuickSetup::Endpoints::CreateConfigurationManager.build(context) + when :delete_configuration_manager + Aws::SSMQuickSetup::Endpoints::DeleteConfigurationManager.build(context) + when :get_configuration_manager + Aws::SSMQuickSetup::Endpoints::GetConfigurationManager.build(context) + when :get_service_settings + Aws::SSMQuickSetup::Endpoints::GetServiceSettings.build(context) + when :list_configuration_managers + Aws::SSMQuickSetup::Endpoints::ListConfigurationManagers.build(context) + when :list_quick_setup_types + Aws::SSMQuickSetup::Endpoints::ListQuickSetupTypes.build(context) + when :list_tags_for_resource + Aws::SSMQuickSetup::Endpoints::ListTagsForResource.build(context) + when :tag_resource + Aws::SSMQuickSetup::Endpoints::TagResource.build(context) + when :untag_resource + Aws::SSMQuickSetup::Endpoints::UntagResource.build(context) + when :update_configuration_definition + Aws::SSMQuickSetup::Endpoints::UpdateConfigurationDefinition.build(context) + when :update_configuration_manager + Aws::SSMQuickSetup::Endpoints::UpdateConfigurationManager.build(context) + when :update_service_settings + Aws::SSMQuickSetup::Endpoints::UpdateServiceSettings.build(context) + end + end + end + + def add_handlers(handlers, _config) + handlers.add(Handler, step: :build, priority: 75) + end + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/resource.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/resource.rb new file mode 100644 index 00000000000..368e58f8171 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/resource.rb @@ -0,0 +1,26 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws::SSMQuickSetup + + class Resource + + # @param options ({}) + # @option options [Client] :client + def initialize(options = {}) + @client = options[:client] || Client.new(options) + end + + # @return [Client] + def client + @client + end + + end +end diff --git a/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/types.rb b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/types.rb new file mode 100644 index 00000000000..09994698d03 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/lib/aws-sdk-ssmquicksetup/types.rb @@ -0,0 +1,1483 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws::SSMQuickSetup + module Types + + # The requester has insufficient permissions to perform the operation. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/AccessDeniedException AWS API Documentation + # + class AccessDeniedException < Struct.new( + :message) + SENSITIVE = [] + include Aws::Structure + end + + # The definition of a Quick Setup configuration. + # + # @!attribute [rw] id + # The ID of the configuration definition. + # @return [String] + # + # @!attribute [rw] local_deployment_administration_role_arn + # The ARN of the IAM role used to administrate local configuration + # deployments. + # @return [String] + # + # @!attribute [rw] local_deployment_execution_role_name + # The name of the IAM role used to deploy local configurations. + # @return [String] + # + # @!attribute [rw] parameters + # A list of key-value pairs containing the required parameters for the + # configuration type. + # @return [Hash] + # + # @!attribute [rw] type + # The type of the Quick Setup configuration. + # @return [String] + # + # @!attribute [rw] type_version + # The version of the Quick Setup type used. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ConfigurationDefinition AWS API Documentation + # + class ConfigurationDefinition < Struct.new( + :id, + :local_deployment_administration_role_arn, + :local_deployment_execution_role_name, + :parameters, + :type, + :type_version) + SENSITIVE = [] + include Aws::Structure + end + + # Defines the preferences and options for a configuration definition. + # + # @!attribute [rw] local_deployment_administration_role_arn + # The ARN of the IAM role used to administrate local configuration + # deployments. + # @return [String] + # + # @!attribute [rw] local_deployment_execution_role_name + # The name of the IAM role used to deploy local configurations. + # @return [String] + # + # @!attribute [rw] parameters + # The parameters for the configuration definition type. Parameters for + # configuration definitions vary based the configuration type. The + # following tables outline the parameters for each configuration type. + # + # OpsCenter (Type: Amazon Web ServicesQuickSetupType-SSMOpsCenter) + # : * `DelegatedAccountId` + # + # * Description: (Required) The ID of the delegated administrator + # account. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Required) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Resource Scheduler (Type: Amazon Web ServicesQuickSetupType-Scheduler) + # : * `TargetTagKey` + # + # * Description: (Required) The tag key assigned to the instances + # you want to target. + # + # ^ + # + # * `TargetTagValue` + # + # * Description: (Required) The value of the tag key assigned to + # the instances you want to target. + # + # ^ + # + # * `ICalendarString` + # + # * Description: (Required) An iCalendar formatted string + # containing the schedule you want Change Manager to use. + # + # ^ + # + # * `TargetAccounts` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account initiating the configuration deployment. You only need + # to provide a value for this parameter if you want to deploy + # the configuration locally. A value must be provided for either + # `TargetAccounts` or `TargetOrganizationalUnits`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Optional) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Default Host Management Configuration (Type: Amazon Web ServicesQuickSetupType-DHMC) + # : * `UpdateSSMAgent` + # + # * Description: (Optional) A boolean value that determines + # whether the SSM Agent is updated on the target instances every + # 2 weeks. The default value is "`true`". + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Required) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Resource Explorer (Type: Amazon Web ServicesQuickSetupType-ResourceExplorer) + # : * `SelectedAggregatorRegion` + # + # * Description: (Required) The Amazon Web Services Region where + # you want to create the aggregator index. + # + # ^ + # + # * `ReplaceExistingAggregator` + # + # * Description: (Required) A boolean value that determines + # whether to demote an existing aggregator if it is in a Region + # that differs from the value you specify for the + # `SelectedAggregatorRegion`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Required) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Change Manager (Type: Amazon Web ServicesQuickSetupType-SSMChangeMgr) + # : * `DelegatedAccountId` + # + # * Description: (Required) The ID of the delegated administrator + # account. + # + # ^ + # + # * `JobFunction` + # + # * Description: (Required) The name for the Change Manager job + # function. + # + # ^ + # + # * `PermissionType` + # + # * Description: (Optional) Specifies whether you want to use + # default administrator permissions for the job function role, + # or provide a custom IAM policy. The valid values are + # `CustomPermissions` and `AdminPermissions`. The default value + # for the parameter is `CustomerPermissions`. + # + # ^ + # + # * `CustomPermissions` + # + # * Description: (Optional) A JSON string containing the IAM + # policy you want your job function to use. You must provide a + # value for this parameter if you specify `CustomPermissions` + # for the `PermissionType` parameter. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Required) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # DevOps Guru (Type: Amazon Web ServicesQuickSetupType-DevOpsGuru) + # : * `AnalyseAllResources` + # + # * Description: (Optional) A boolean value that determines + # whether DevOps Guru analyzes all CloudFormation stacks in the + # account. The default value is "`false`". + # + # ^ + # + # * `EnableSnsNotifications` + # + # * Description: (Optional) A boolean value that determines + # whether DevOps Guru sends notifications when an insight is + # created. The default value is "`true`". + # + # ^ + # + # * `EnableSsmOpsItems` + # + # * Description: (Optional) A boolean value that determines + # whether DevOps Guru creates an OpsCenter OpsItem when an + # insight is created. The default value is "`true`". + # + # ^ + # + # * `EnableDriftRemediation` + # + # * Description: (Optional) A boolean value that determines + # whether a drift remediation schedule is used. The default + # value is "`false`". + # + # ^ + # + # * `RemediationSchedule` + # + # * Description: (Optional) A rate expression that defines the + # schedule for drift remediation. The valid values are `rate(30 + # days)`, `rate(14 days)`, `rate(1 days)`, and `none`. The + # default value is "`none`". + # + # ^ + # + # * `TargetAccounts` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account initiating the configuration deployment. You only need + # to provide a value for this parameter if you want to deploy + # the configuration locally. A value must be provided for either + # `TargetAccounts` or `TargetOrganizationalUnits`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Optional) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Conformance Packs (Type: Amazon Web ServicesQuickSetupType-CFGCPacks) + # : * `DelegatedAccountId` + # + # * Description: (Optional) The ID of the delegated administrator + # account. This parameter is required for Organization + # deployments. + # + # ^ + # + # * `RemediationSchedule` + # + # * Description: (Optional) A rate expression that defines the + # schedule for drift remediation. The valid values are `rate(30 + # days)`, `rate(14 days)`, `rate(2 days)`, and `none`. The + # default value is "`none`". + # + # ^ + # + # * `CPackNames` + # + # * Description: (Required) A comma separated list of Config + # conformance packs. + # + # ^ + # + # * `TargetAccounts` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account initiating the configuration deployment. You only need + # to provide a value for this parameter if you want to deploy + # the configuration locally. A value must be provided for either + # `TargetAccounts` or `TargetOrganizationalUnits`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Optional) The ID of the root of your + # Organization. This configuration type doesn't currently + # support choosing specific OUs. The configuration will be + # deployed to all the OUs in the Organization. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Config Recording (Type: Amazon Web ServicesQuickSetupType-CFGRecording) + # : * `RecordAllResources` + # + # * Description: (Optional) A boolean value that determines + # whether all supported resources are recorded. The default + # value is "`true`". + # + # ^ + # + # * `ResourceTypesToRecord` + # + # * Description: (Optional) A comma separated list of resource + # types you want to record. + # + # ^ + # + # * `RecordGlobalResourceTypes` + # + # * Description: (Optional) A boolean value that determines + # whether global resources are recorded with all resource + # configurations. The default value is "`false`". + # + # ^ + # + # * `GlobalResourceTypesRegion` + # + # * Description: (Optional) Determines the Amazon Web Services + # Region where global resources are recorded. + # + # ^ + # + # * `UseCustomBucket` + # + # * Description: (Optional) A boolean value that determines + # whether a custom Amazon S3 bucket is used for delivery. The + # default value is "`false`". + # + # ^ + # + # * `DeliveryBucketName` + # + # * Description: (Optional) The name of the Amazon S3 bucket you + # want Config to deliver configuration snapshots and + # configuration history files to. + # + # ^ + # + # * `DeliveryBucketPrefix` + # + # * Description: (Optional) The key prefix you want to use in the + # custom Amazon S3 bucket. + # + # ^ + # + # * `NotificationOptions` + # + # * Description: (Optional) Determines the notification + # configuration for the recorder. The valid values are + # `NoStreaming`, `UseExistingTopic`, and `CreateTopic`. The + # default value is `NoStreaming`. + # + # ^ + # + # * `CustomDeliveryTopicAccountId` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account where the Amazon SNS topic you want to use for + # notifications resides. You must specify a value for this + # parameter if you use the `UseExistingTopic` notification + # option. + # + # ^ + # + # * `CustomDeliveryTopicName` + # + # * Description: (Optional) The name of the Amazon SNS topic you + # want to use for notifications. You must specify a value for + # this parameter if you use the `UseExistingTopic` notification + # option. + # + # ^ + # + # * `RemediationSchedule` + # + # * Description: (Optional) A rate expression that defines the + # schedule for drift remediation. The valid values are `rate(30 + # days)`, `rate(7 days)`, `rate(1 days)`, and `none`. The + # default value is "`none`". + # + # ^ + # + # * `TargetAccounts` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account initiating the configuration deployment. You only need + # to provide a value for this parameter if you want to deploy + # the configuration locally. A value must be provided for either + # `TargetAccounts` or `TargetOrganizationalUnits`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Optional) The ID of the root of your + # Organization. This configuration type doesn't currently + # support choosing specific OUs. The configuration will be + # deployed to all the OUs in the Organization. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Host Management (Type: Amazon Web ServicesQuickSetupType-SSMHostMgmt) + # : * `UpdateSSMAgent` + # + # * Description: (Optional) A boolean value that determines + # whether the SSM Agent is updated on the target instances every + # 2 weeks. The default value is "`true`". + # + # ^ + # + # * `UpdateEc2LaunchAgent` + # + # * Description: (Optional) A boolean value that determines + # whether the EC2 Launch agent is updated on the target + # instances every month. The default value is "`false`". + # + # ^ + # + # * `CollectInventory` + # + # * Description: (Optional) A boolean value that determines + # whether the EC2 Launch agent is updated on the target + # instances every month. The default value is "`true`". + # + # ^ + # + # * `ScanInstances` + # + # * Description: (Optional) A boolean value that determines + # whether the target instances are scanned daily for available + # patches. The default value is "`true`". + # + # ^ + # + # * `InstallCloudWatchAgent` + # + # * Description: (Optional) A boolean value that determines + # whether the Amazon CloudWatch agent is installed on the target + # instances. The default value is "`false`". + # + # ^ + # + # * `UpdateCloudWatchAgent` + # + # * Description: (Optional) A boolean value that determines + # whether the Amazon CloudWatch agent is updated on the target + # instances every month. The default value is "`false`". + # + # ^ + # + # * `IsPolicyAttachAllowed` + # + # * Description: (Optional) A boolean value that determines + # whether Quick Setup attaches policies to instances profiles + # already associated with the target instances. The default + # value is "`false`". + # + # ^ + # + # * `TargetType` + # + # * Description: (Optional) Determines how instances are targeted + # for local account deployments. Don't specify a value for this + # parameter if you're deploying to OUs. The valid values are + # `*`, `InstanceIds`, `ResourceGroups`, and `Tags`. Use `*` to + # target all instances in the account. + # + # ^ + # + # * `TargetInstances` + # + # * Description: (Optional) A comma separated list of instance + # IDs. You must provide a value for this parameter if you + # specify `InstanceIds` for the `TargetType` parameter. + # + # ^ + # + # * `TargetTagKey` + # + # * Description: (Optional) The tag key assigned to the instances + # you want to target. You must provide a value for this + # parameter if you specify `Tags` for the `TargetType` + # parameter. + # + # ^ + # + # * `TargetTagValue` + # + # * Description: (Optional) The value of the tag key assigned to + # the instances you want to target. You must provide a value for + # this parameter if you specify `Tags` for the `TargetType` + # parameter. + # + # ^ + # + # * `ResourceGroupName` + # + # * Description: (Optional) The name of the resource group + # associated with the instances you want to target. You must + # provide a value for this parameter if you specify + # `ResourceGroups` for the `TargetType` parameter. + # + # ^ + # + # * `TargetAccounts` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account initiating the configuration deployment. You only need + # to provide a value for this parameter if you want to deploy + # the configuration locally. A value must be provided for either + # `TargetAccounts` or `TargetOrganizationalUnits`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Optional) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Distributor (Type: Amazon Web ServicesQuickSetupType-Distributor) + # : * `PackagesToInstall` + # + # * Description: (Required) A comma separated list of packages you + # want to install on the target instances. The valid values are + # `AWSEFSTools`, `AWSCWAgent`, and `AWSEC2LaunchAgent`. + # + # ^ + # + # * `RemediationSchedule` + # + # * Description: (Optional) A rate expression that defines the + # schedule for drift remediation. The valid values are `rate(30 + # days)`, `rate(14 days)`, `rate(2 days)`, and `none`. The + # default value is "`rate(30 days)`". + # + # ^ + # + # * `IsPolicyAttachAllowed` + # + # * Description: (Optional) A boolean value that determines + # whether Quick Setup attaches policies to instances profiles + # already associated with the target instances. The default + # value is "`false`". + # + # ^ + # + # * `TargetType` + # + # * Description: (Optional) Determines how instances are targeted + # for local account deployments. Don't specify a value for this + # parameter if you're deploying to OUs. The valid values are + # `*`, `InstanceIds`, `ResourceGroups`, and `Tags`. Use `*` to + # target all instances in the account. + # + # ^ + # + # * `TargetInstances` + # + # * Description: (Optional) A comma separated list of instance + # IDs. You must provide a value for this parameter if you + # specify `InstanceIds` for the `TargetType` parameter. + # + # ^ + # + # * `TargetTagKey` + # + # * Description: (Required) The tag key assigned to the instances + # you want to target. You must provide a value for this + # parameter if you specify `Tags` for the `TargetType` + # parameter. + # + # ^ + # + # * `TargetTagValue` + # + # * Description: (Required) The value of the tag key assigned to + # the instances you want to target. You must provide a value for + # this parameter if you specify `Tags` for the `TargetType` + # parameter. + # + # ^ + # + # * `ResourceGroupName` + # + # * Description: (Required) The name of the resource group + # associated with the instances you want to target. You must + # provide a value for this parameter if you specify + # `ResourceGroups` for the `TargetType` parameter. + # + # ^ + # + # * `TargetAccounts` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account initiating the configuration deployment. You only need + # to provide a value for this parameter if you want to deploy + # the configuration locally. A value must be provided for either + # `TargetAccounts` or `TargetOrganizationalUnits`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Optional) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # + # Patch Policy (Type: Amazon Web ServicesQuickSetupType-PatchPolicy) + # : * `PatchPolicyName` + # + # * Description: (Required) A name for the patch policy. The value + # you provide is applied to target Amazon EC2 instances as a + # tag. + # + # ^ + # + # * `SelectedPatchBaselines` + # + # * Description: (Required) An array of JSON objects containing + # the information for the patch baselines to include in your + # patch policy. + # + # ^ + # + # * `PatchBaselineUseDefault` + # + # * Description: (Optional) A boolean value that determines + # whether the selected patch baselines are all Amazon Web + # Services provided. + # + # ^ + # + # * `ConfigurationOptionsPatchOperation` + # + # * Description: (Optional) Determines whether target instances + # scan for available patches, or scan and install available + # patches. The valid values are `Scan` and `ScanAndInstall`. The + # default value for the parameter is `Scan`. + # + # ^ + # + # * `ConfigurationOptionsScanValue` + # + # * Description: (Optional) A cron expression that is used as the + # schedule for when instances scan for available patches. + # + # ^ + # + # * `ConfigurationOptionsInstallValue` + # + # * Description: (Optional) A cron expression that is used as the + # schedule for when instances install available patches. + # + # ^ + # + # * `ConfigurationOptionsScanNextInterval` + # + # * Description: (Optional) A boolean value that determines + # whether instances should scan for available patches at the + # next cron interval. The default value is "`false`". + # + # ^ + # + # * `ConfigurationOptionsInstallNextInterval` + # + # * Description: (Optional) A boolean value that determines + # whether instances should scan for available patches at the + # next cron interval. The default value is "`false`". + # + # ^ + # + # * `RebootOption` + # + # * Description: (Optional) A boolean value that determines + # whether instances are rebooted after patches are installed. + # The default value is "`false`". + # + # ^ + # + # * `IsPolicyAttachAllowed` + # + # * Description: (Optional) A boolean value that determines + # whether Quick Setup attaches policies to instances profiles + # already associated with the target instances. The default + # value is "`false`". + # + # ^ + # + # * `OutputLogEnableS3` + # + # * Description: (Optional) A boolean value that determines + # whether command output logs are sent to Amazon S3. + # + # ^ + # + # * `OutputS3Location` + # + # * Description: (Optional) A JSON string containing information + # about the Amazon S3 bucket where you want to store the output + # details of the request. + # + # * `OutputS3BucketRegion` + # + # * Description: (Optional) The Amazon Web Services Region + # where the Amazon S3 bucket you want Config to deliver + # command output to is located. + # + # ^ + # + # * `OutputS3BucketName` + # + # * Description: (Optional) The name of the Amazon S3 bucket + # you want Config to deliver command output to. + # + # ^ + # + # * `OutputS3KeyPrefix` + # + # * Description: (Optional) The key prefix you want to use in + # the custom Amazon S3 bucket. + # + # ^ + # + # * `TargetType` + # + # * Description: (Optional) Determines how instances are targeted + # for local account deployments. Don't specify a value for this + # parameter if you're deploying to OUs. The valid values are + # `*`, `InstanceIds`, `ResourceGroups`, and `Tags`. Use `*` to + # target all instances in the account. + # + # ^ + # + # * `TargetInstances` + # + # * Description: (Optional) A comma separated list of instance + # IDs. You must provide a value for this parameter if you + # specify `InstanceIds` for the `TargetType` parameter. + # + # ^ + # + # * `TargetTagKey` + # + # * Description: (Required) The tag key assigned to the instances + # you want to target. You must provide a value for this + # parameter if you specify `Tags` for the `TargetType` + # parameter. + # + # ^ + # + # * `TargetTagValue` + # + # * Description: (Required) The value of the tag key assigned to + # the instances you want to target. You must provide a value for + # this parameter if you specify `Tags` for the `TargetType` + # parameter. + # + # ^ + # + # * `ResourceGroupName` + # + # * Description: (Required) The name of the resource group + # associated with the instances you want to target. You must + # provide a value for this parameter if you specify + # `ResourceGroups` for the `TargetType` parameter. + # + # ^ + # + # * `TargetAccounts` + # + # * Description: (Optional) The ID of the Amazon Web Services + # account initiating the configuration deployment. You only need + # to provide a value for this parameter if you want to deploy + # the configuration locally. A value must be provided for either + # `TargetAccounts` or `TargetOrganizationalUnits`. + # + # ^ + # + # * `TargetOrganizationalUnits` + # + # * Description: (Optional) A comma separated list of + # organizational units (OUs) you want to deploy the + # configuration to. + # + # ^ + # + # * `TargetRegions` + # + # * Description: (Required) A comma separated list of Amazon Web + # Services Regions you want to deploy the configuration to. + # + # ^ + # @return [Hash] + # + # @!attribute [rw] type + # The type of the Quick Setup configuration. + # @return [String] + # + # @!attribute [rw] type_version + # The version of the Quick Setup type to use. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ConfigurationDefinitionInput AWS API Documentation + # + class ConfigurationDefinitionInput < Struct.new( + :local_deployment_administration_role_arn, + :local_deployment_execution_role_name, + :parameters, + :type, + :type_version) + SENSITIVE = [] + include Aws::Structure + end + + # A summarized definition of a Quick Setup configuration definition. + # + # @!attribute [rw] first_class_parameters + # The common parameters and values for the configuration definition. + # @return [Hash] + # + # @!attribute [rw] id + # The ID of the configuration definition. + # @return [String] + # + # @!attribute [rw] type + # The type of the Quick Setup configuration used by the configuration + # definition. + # @return [String] + # + # @!attribute [rw] type_version + # The version of the Quick Setup type used by the configuration + # definition. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ConfigurationDefinitionSummary AWS API Documentation + # + class ConfigurationDefinitionSummary < Struct.new( + :first_class_parameters, + :id, + :type, + :type_version) + SENSITIVE = [] + include Aws::Structure + end + + # A summary of a Quick Setup configuration manager. + # + # @!attribute [rw] configuration_definition_summaries + # A summary of the Quick Setup configuration definition. + # @return [Array] + # + # @!attribute [rw] description + # The description of the configuration. + # @return [String] + # + # @!attribute [rw] manager_arn + # The ARN of the Quick Setup configuration. + # @return [String] + # + # @!attribute [rw] name + # The name of the configuration + # @return [String] + # + # @!attribute [rw] status_summaries + # Summaries of the state of the configuration manager. These summaries + # include an aggregate of the statuses from the configuration + # definition associated with the configuration manager. This includes + # deployment statuses, association statuses, drift statuses, health + # checks, and more. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ConfigurationManagerSummary AWS API Documentation + # + class ConfigurationManagerSummary < Struct.new( + :configuration_definition_summaries, + :description, + :manager_arn, + :name, + :status_summaries) + SENSITIVE = [] + include Aws::Structure + end + + # Another request is being processed. Wait a few minutes and try again. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ConflictException AWS API Documentation + # + class ConflictException < Struct.new( + :message) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] configuration_definitions + # The definition of the Quick Setup configuration that the + # configuration manager deploys. + # @return [Array] + # + # @!attribute [rw] description + # A description of the configuration manager. + # @return [String] + # + # @!attribute [rw] name + # A name for the configuration manager. + # @return [String] + # + # @!attribute [rw] tags + # Key-value pairs of metadata to assign to the configuration manager. + # @return [Hash] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/CreateConfigurationManagerInput AWS API Documentation + # + class CreateConfigurationManagerInput < Struct.new( + :configuration_definitions, + :description, + :name, + :tags) + SENSITIVE = [:tags] + include Aws::Structure + end + + # @!attribute [rw] manager_arn + # The ARN for the newly created configuration manager. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/CreateConfigurationManagerOutput AWS API Documentation + # + class CreateConfigurationManagerOutput < Struct.new( + :manager_arn) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] manager_arn + # The ID of the configuration manager. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/DeleteConfigurationManagerInput AWS API Documentation + # + class DeleteConfigurationManagerInput < Struct.new( + :manager_arn) + SENSITIVE = [] + include Aws::Structure + end + + # A key-value pair to filter results. + # + # @!attribute [rw] key + # The key for the filter. + # @return [String] + # + # @!attribute [rw] values + # The values for the filter keys. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/Filter AWS API Documentation + # + class Filter < Struct.new( + :key, + :values) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] manager_arn + # The ARN of the configuration manager. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/GetConfigurationManagerInput AWS API Documentation + # + class GetConfigurationManagerInput < Struct.new( + :manager_arn) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] configuration_definitions + # The configuration definitions association with the configuration + # manager. + # @return [Array] + # + # @!attribute [rw] created_at + # The datetime stamp when the configuration manager was created. + # @return [Time] + # + # @!attribute [rw] description + # The description of the configuration manager. + # @return [String] + # + # @!attribute [rw] last_modified_at + # The datetime stamp when the configuration manager was last updated. + # @return [Time] + # + # @!attribute [rw] manager_arn + # The ARN of the configuration manager. + # @return [String] + # + # @!attribute [rw] name + # The name of the configuration manager. + # @return [String] + # + # @!attribute [rw] status_summaries + # A summary of the state of the configuration manager. This includes + # deployment statuses, association statuses, drift statuses, health + # checks, and more. + # @return [Array] + # + # @!attribute [rw] tags + # Key-value pairs of metadata to assign to the configuration manager. + # @return [Hash] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/GetConfigurationManagerOutput AWS API Documentation + # + class GetConfigurationManagerOutput < Struct.new( + :configuration_definitions, + :created_at, + :description, + :last_modified_at, + :manager_arn, + :name, + :status_summaries, + :tags) + SENSITIVE = [:tags] + include Aws::Structure + end + + # @!attribute [rw] service_settings + # Returns details about the settings for Quick Setup in the requesting + # Amazon Web Services account and Amazon Web Services Region. + # @return [Types::ServiceSettings] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/GetServiceSettingsOutput AWS API Documentation + # + class GetServiceSettingsOutput < Struct.new( + :service_settings) + SENSITIVE = [] + include Aws::Structure + end + + # An error occurred on the server side. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/InternalServerException AWS API Documentation + # + class InternalServerException < Struct.new( + :message) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] filters + # Filters the results returned by the request. + # @return [Array] + # + # @!attribute [rw] max_items + # Specifies the maximum number of configuration managers that are + # returned by the request. + # @return [Integer] + # + # @!attribute [rw] starting_token + # The token to use when requesting a specific set of items from a + # list. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListConfigurationManagersInput AWS API Documentation + # + class ListConfigurationManagersInput < Struct.new( + :filters, + :max_items, + :starting_token) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] configuration_managers_list + # The configuration managers returned by the request. + # @return [Array] + # + # @!attribute [rw] next_token + # The token to use when requesting the next set of configuration + # managers. If there are no additional operations to return, the + # string is empty. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListConfigurationManagersOutput AWS API Documentation + # + class ListConfigurationManagersOutput < Struct.new( + :configuration_managers_list, + :next_token) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] quick_setup_type_list + # An array of Quick Setup types. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListQuickSetupTypesOutput AWS API Documentation + # + class ListQuickSetupTypesOutput < Struct.new( + :quick_setup_type_list) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] resource_arn + # The ARN of the resource the tag is assigned to. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListTagsForResourceRequest AWS API Documentation + # + class ListTagsForResourceRequest < Struct.new( + :resource_arn) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] tags + # Key-value pairs of metadata assigned to the resource. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ListTagsForResourceResponse AWS API Documentation + # + class ListTagsForResourceResponse < Struct.new( + :tags) + SENSITIVE = [:tags] + include Aws::Structure + end + + # Information about the Quick Setup type. + # + # @!attribute [rw] latest_version + # The latest version number of the configuration. + # @return [String] + # + # @!attribute [rw] type + # The type of the Quick Setup configuration. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/QuickSetupTypeOutput AWS API Documentation + # + class QuickSetupTypeOutput < Struct.new( + :latest_version, + :type) + SENSITIVE = [] + include Aws::Structure + end + + # The resource couldn't be found. Check the ID or name and try again. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ResourceNotFoundException AWS API Documentation + # + class ResourceNotFoundException < Struct.new( + :message) + SENSITIVE = [] + include Aws::Structure + end + + # Settings configured for Quick Setup. + # + # @!attribute [rw] explorer_enabling_role_arn + # The IAM role used to enable Explorer. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ServiceSettings AWS API Documentation + # + class ServiceSettings < Struct.new( + :explorer_enabling_role_arn) + SENSITIVE = [] + include Aws::Structure + end + + # A summarized description of the status. + # + # @!attribute [rw] last_updated_at + # The datetime stamp when the status was last updated. + # @return [Time] + # + # @!attribute [rw] status + # The current status. + # @return [String] + # + # @!attribute [rw] status_details + # Details about the status. + # @return [Hash] + # + # @!attribute [rw] status_message + # When applicable, returns an informational message relevant to the + # current status and status type of the status summary object. We + # don't recommend implementing parsing logic around this value since + # the messages returned can vary in format. + # @return [String] + # + # @!attribute [rw] status_type + # The type of a status summary. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/StatusSummary AWS API Documentation + # + class StatusSummary < Struct.new( + :last_updated_at, + :status, + :status_details, + :status_message, + :status_type) + SENSITIVE = [] + include Aws::Structure + end + + # Key-value pairs of metadata. + # + # @!attribute [rw] key + # The key for the tag. + # @return [String] + # + # @!attribute [rw] value + # The value for the tag. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/TagEntry AWS API Documentation + # + class TagEntry < Struct.new( + :key, + :value) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] resource_arn + # The ARN of the resource to tag. + # @return [String] + # + # @!attribute [rw] tags + # Key-value pairs of metadata to assign to the resource. + # @return [Hash] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/TagResourceInput AWS API Documentation + # + class TagResourceInput < Struct.new( + :resource_arn, + :tags) + SENSITIVE = [:tags] + include Aws::Structure + end + + # The request or operation exceeds the maximum allowed request rate per + # Amazon Web Services account and Amazon Web Services Region. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ThrottlingException AWS API Documentation + # + class ThrottlingException < Struct.new( + :message) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] resource_arn + # The ARN of the resource to remove tags from. + # @return [String] + # + # @!attribute [rw] tag_keys + # The keys of the tags to remove from the resource. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UntagResourceInput AWS API Documentation + # + class UntagResourceInput < Struct.new( + :resource_arn, + :tag_keys) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] id + # The ID of the configuration definition you want to update. + # @return [String] + # + # @!attribute [rw] local_deployment_administration_role_arn + # The ARN of the IAM role used to administrate local configuration + # deployments. + # @return [String] + # + # @!attribute [rw] local_deployment_execution_role_name + # The name of the IAM role used to deploy local configurations. + # @return [String] + # + # @!attribute [rw] manager_arn + # The ARN of the configuration manager associated with the definition + # to update. + # @return [String] + # + # @!attribute [rw] parameters + # The parameters for the configuration definition type. + # @return [Hash] + # + # @!attribute [rw] type_version + # The version of the Quick Setup type to use. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UpdateConfigurationDefinitionInput AWS API Documentation + # + class UpdateConfigurationDefinitionInput < Struct.new( + :id, + :local_deployment_administration_role_arn, + :local_deployment_execution_role_name, + :manager_arn, + :parameters, + :type_version) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] description + # A description of the configuration manager. + # @return [String] + # + # @!attribute [rw] manager_arn + # The ARN of the configuration manager. + # @return [String] + # + # @!attribute [rw] name + # A name for the configuration manager. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UpdateConfigurationManagerInput AWS API Documentation + # + class UpdateConfigurationManagerInput < Struct.new( + :description, + :manager_arn, + :name) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] explorer_enabling_role_arn + # The IAM role used to enable Explorer. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/UpdateServiceSettingsInput AWS API Documentation + # + class UpdateServiceSettingsInput < Struct.new( + :explorer_enabling_role_arn) + SENSITIVE = [] + include Aws::Structure + end + + # The request is invalid. Verify the values provided for the request + # parameters are accurate. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-quicksetup-2018-05-10/ValidationException AWS API Documentation + # + class ValidationException < Struct.new( + :message) + SENSITIVE = [] + include Aws::Structure + end + + end +end diff --git a/gems/aws-sdk-ssmquicksetup/sig/client.rbs b/gems/aws-sdk-ssmquicksetup/sig/client.rbs new file mode 100644 index 00000000000..0049815c74d --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/sig/client.rbs @@ -0,0 +1,205 @@ +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws + module SSMQuickSetup + class Client < ::Seahorse::Client::Base + include ::Aws::ClientStubs + + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#initialize-instance_method + def self.new: ( + ?credentials: untyped, + ?region: String, + ?access_key_id: String, + ?active_endpoint_cache: bool, + ?adaptive_retry_wait_to_fill: bool, + ?client_side_monitoring: bool, + ?client_side_monitoring_client_id: String, + ?client_side_monitoring_host: String, + ?client_side_monitoring_port: Integer, + ?client_side_monitoring_publisher: untyped, + ?convert_params: bool, + ?correct_clock_skew: bool, + ?defaults_mode: String, + ?disable_host_prefix_injection: bool, + ?disable_request_compression: bool, + ?endpoint: String, + ?endpoint_cache_max_entries: Integer, + ?endpoint_cache_max_threads: Integer, + ?endpoint_cache_poll_interval: Integer, + ?endpoint_discovery: bool, + ?ignore_configured_endpoint_urls: bool, + ?log_formatter: untyped, + ?log_level: Symbol, + ?logger: untyped, + ?max_attempts: Integer, + ?profile: String, + ?request_min_compression_size_bytes: Integer, + ?retry_backoff: Proc, + ?retry_base_delay: Float, + ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer), + ?retry_limit: Integer, + ?retry_max_delay: Integer, + ?retry_mode: ("legacy" | "standard" | "adaptive"), + ?sdk_ua_app_id: String, + ?secret_access_key: String, + ?session_token: String, + ?sigv4a_signing_region_set: Array[String], + ?stub_responses: untyped, + ?token_provider: untyped, + ?use_dualstack_endpoint: bool, + ?use_fips_endpoint: bool, + ?validate_params: bool, + ?endpoint_provider: untyped, + ?http_proxy: String, + ?http_open_timeout: (Float | Integer), + ?http_read_timeout: (Float | Integer), + ?http_idle_timeout: (Float | Integer), + ?http_continue_timeout: (Float | Integer), + ?ssl_timeout: (Float | Integer | nil), + ?http_wire_trace: bool, + ?ssl_verify_peer: bool, + ?ssl_ca_bundle: String, + ?ssl_ca_directory: String, + ?ssl_ca_store: String, + ?on_chunk_received: Proc, + ?on_chunk_sent: Proc, + ?raise_response_errors: bool + ) -> instance + | (?Hash[Symbol, untyped]) -> instance + + + interface _CreateConfigurationManagerResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::CreateConfigurationManagerOutput] + def manager_arn: () -> ::String + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#create_configuration_manager-instance_method + def create_configuration_manager: ( + configuration_definitions: Array[ + { + local_deployment_administration_role_arn: ::String?, + local_deployment_execution_role_name: ::String?, + parameters: Hash[::String, ::String], + type: ::String, + type_version: ::String? + }, + ], + ?description: ::String, + ?name: ::String, + ?tags: Hash[::String, ::String] + ) -> _CreateConfigurationManagerResponseSuccess + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateConfigurationManagerResponseSuccess + + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#delete_configuration_manager-instance_method + def delete_configuration_manager: ( + manager_arn: ::String + ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + + interface _GetConfigurationManagerResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::GetConfigurationManagerOutput] + def configuration_definitions: () -> ::Array[Types::ConfigurationDefinition] + def created_at: () -> ::Time + def description: () -> ::String + def last_modified_at: () -> ::Time + def manager_arn: () -> ::String + def name: () -> ::String + def status_summaries: () -> ::Array[Types::StatusSummary] + def tags: () -> ::Hash[::String, ::String] + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#get_configuration_manager-instance_method + def get_configuration_manager: ( + manager_arn: ::String + ) -> _GetConfigurationManagerResponseSuccess + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetConfigurationManagerResponseSuccess + + interface _GetServiceSettingsResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::GetServiceSettingsOutput] + def service_settings: () -> Types::ServiceSettings + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#get_service_settings-instance_method + def get_service_settings: () -> _GetServiceSettingsResponseSuccess + | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetServiceSettingsResponseSuccess + + interface _ListConfigurationManagersResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::ListConfigurationManagersOutput] + def configuration_managers_list: () -> ::Array[Types::ConfigurationManagerSummary] + def next_token: () -> ::String + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#list_configuration_managers-instance_method + def list_configuration_managers: ( + ?filters: Array[ + { + key: ::String, + values: Array[::String] + }, + ], + ?max_items: ::Integer, + ?starting_token: ::String + ) -> _ListConfigurationManagersResponseSuccess + | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListConfigurationManagersResponseSuccess + + interface _ListQuickSetupTypesResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::ListQuickSetupTypesOutput] + def quick_setup_type_list: () -> ::Array[Types::QuickSetupTypeOutput] + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#list_quick_setup_types-instance_method + def list_quick_setup_types: () -> _ListQuickSetupTypesResponseSuccess + | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListQuickSetupTypesResponseSuccess + + interface _ListTagsForResourceResponseSuccess + include ::Seahorse::Client::_ResponseSuccess[Types::ListTagsForResourceResponse] + def tags: () -> ::Array[Types::TagEntry] + end + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#list_tags_for_resource-instance_method + def list_tags_for_resource: ( + resource_arn: ::String + ) -> _ListTagsForResourceResponseSuccess + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListTagsForResourceResponseSuccess + + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#tag_resource-instance_method + def tag_resource: ( + resource_arn: ::String, + tags: Hash[::String, ::String] + ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#untag_resource-instance_method + def untag_resource: ( + resource_arn: ::String, + tag_keys: Array[::String] + ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#update_configuration_definition-instance_method + def update_configuration_definition: ( + id: ::String, + ?local_deployment_administration_role_arn: ::String, + ?local_deployment_execution_role_name: ::String, + manager_arn: ::String, + ?parameters: Hash[::String, ::String], + ?type_version: ::String + ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#update_configuration_manager-instance_method + def update_configuration_manager: ( + ?description: ::String, + manager_arn: ::String, + ?name: ::String + ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Client.html#update_service_settings-instance_method + def update_service_settings: ( + ?explorer_enabling_role_arn: ::String + ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure] + end + end +end + diff --git a/gems/aws-sdk-ssmquicksetup/sig/errors.rbs b/gems/aws-sdk-ssmquicksetup/sig/errors.rbs new file mode 100644 index 00000000000..3532fe2aa6f --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/sig/errors.rbs @@ -0,0 +1,34 @@ +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws + module SSMQuickSetup + module Errors + class ServiceError < ::Aws::Errors::ServiceError + end + + class AccessDeniedException < ::Aws::Errors::ServiceError + def message: () -> ::String + end + class ConflictException < ::Aws::Errors::ServiceError + def message: () -> ::String + end + class InternalServerException < ::Aws::Errors::ServiceError + def message: () -> ::String + end + class ResourceNotFoundException < ::Aws::Errors::ServiceError + def message: () -> ::String + end + class ThrottlingException < ::Aws::Errors::ServiceError + def message: () -> ::String + end + class ValidationException < ::Aws::Errors::ServiceError + def message: () -> ::String + end + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/sig/resource.rbs b/gems/aws-sdk-ssmquicksetup/sig/resource.rbs new file mode 100644 index 00000000000..2d9a87d53bf --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/sig/resource.rbs @@ -0,0 +1,80 @@ +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws + module SSMQuickSetup + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Resource.html + class Resource + # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SSMQuickSetup/Resource.html#initialize-instance_method + def initialize: ( + ?client: Client, + ?credentials: untyped, + ?region: String, + ?access_key_id: String, + ?active_endpoint_cache: bool, + ?adaptive_retry_wait_to_fill: bool, + ?client_side_monitoring: bool, + ?client_side_monitoring_client_id: String, + ?client_side_monitoring_host: String, + ?client_side_monitoring_port: Integer, + ?client_side_monitoring_publisher: untyped, + ?convert_params: bool, + ?correct_clock_skew: bool, + ?defaults_mode: String, + ?disable_host_prefix_injection: bool, + ?disable_request_compression: bool, + ?endpoint: String, + ?endpoint_cache_max_entries: Integer, + ?endpoint_cache_max_threads: Integer, + ?endpoint_cache_poll_interval: Integer, + ?endpoint_discovery: bool, + ?ignore_configured_endpoint_urls: bool, + ?log_formatter: untyped, + ?log_level: Symbol, + ?logger: untyped, + ?max_attempts: Integer, + ?profile: String, + ?request_min_compression_size_bytes: Integer, + ?retry_backoff: Proc, + ?retry_base_delay: Float, + ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer), + ?retry_limit: Integer, + ?retry_max_delay: Integer, + ?retry_mode: ("legacy" | "standard" | "adaptive"), + ?sdk_ua_app_id: String, + ?secret_access_key: String, + ?session_token: String, + ?sigv4a_signing_region_set: Array[String], + ?stub_responses: untyped, + ?token_provider: untyped, + ?use_dualstack_endpoint: bool, + ?use_fips_endpoint: bool, + ?validate_params: bool, + ?endpoint_provider: untyped, + ?http_proxy: String, + ?http_open_timeout: (Float | Integer), + ?http_read_timeout: (Float | Integer), + ?http_idle_timeout: (Float | Integer), + ?http_continue_timeout: (Float | Integer), + ?ssl_timeout: (Float | Integer | nil), + ?http_wire_trace: bool, + ?ssl_verify_peer: bool, + ?ssl_ca_bundle: String, + ?ssl_ca_directory: String, + ?ssl_ca_store: String, + ?on_chunk_received: Proc, + ?on_chunk_sent: Proc, + ?raise_response_errors: bool + ) -> void + | (?Hash[Symbol, untyped]) -> void + + def client: () -> Client + + + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/sig/types.rbs b/gems/aws-sdk-ssmquicksetup/sig/types.rbs new file mode 100644 index 00000000000..315c22b86a8 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/sig/types.rbs @@ -0,0 +1,211 @@ +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws::SSMQuickSetup + module Types + + class AccessDeniedException + attr_accessor message: ::String + SENSITIVE: [] + end + + class ConfigurationDefinition + attr_accessor id: ::String + attr_accessor local_deployment_administration_role_arn: ::String + attr_accessor local_deployment_execution_role_name: ::String + attr_accessor parameters: ::Hash[::String, ::String] + attr_accessor type: ::String + attr_accessor type_version: ::String + SENSITIVE: [] + end + + class ConfigurationDefinitionInput + attr_accessor local_deployment_administration_role_arn: ::String + attr_accessor local_deployment_execution_role_name: ::String + attr_accessor parameters: ::Hash[::String, ::String] + attr_accessor type: ::String + attr_accessor type_version: ::String + SENSITIVE: [] + end + + class ConfigurationDefinitionSummary + attr_accessor first_class_parameters: ::Hash[::String, ::String] + attr_accessor id: ::String + attr_accessor type: ::String + attr_accessor type_version: ::String + SENSITIVE: [] + end + + class ConfigurationManagerSummary + attr_accessor configuration_definition_summaries: ::Array[Types::ConfigurationDefinitionSummary] + attr_accessor description: ::String + attr_accessor manager_arn: ::String + attr_accessor name: ::String + attr_accessor status_summaries: ::Array[Types::StatusSummary] + SENSITIVE: [] + end + + class ConflictException + attr_accessor message: ::String + SENSITIVE: [] + end + + class CreateConfigurationManagerInput + attr_accessor configuration_definitions: ::Array[Types::ConfigurationDefinitionInput] + attr_accessor description: ::String + attr_accessor name: ::String + attr_accessor tags: ::Hash[::String, ::String] + SENSITIVE: [:tags] + end + + class CreateConfigurationManagerOutput + attr_accessor manager_arn: ::String + SENSITIVE: [] + end + + class DeleteConfigurationManagerInput + attr_accessor manager_arn: ::String + SENSITIVE: [] + end + + class Filter + attr_accessor key: ::String + attr_accessor values: ::Array[::String] + SENSITIVE: [] + end + + class GetConfigurationManagerInput + attr_accessor manager_arn: ::String + SENSITIVE: [] + end + + class GetConfigurationManagerOutput + attr_accessor configuration_definitions: ::Array[Types::ConfigurationDefinition] + attr_accessor created_at: ::Time + attr_accessor description: ::String + attr_accessor last_modified_at: ::Time + attr_accessor manager_arn: ::String + attr_accessor name: ::String + attr_accessor status_summaries: ::Array[Types::StatusSummary] + attr_accessor tags: ::Hash[::String, ::String] + SENSITIVE: [:tags] + end + + class GetServiceSettingsOutput + attr_accessor service_settings: Types::ServiceSettings + SENSITIVE: [] + end + + class InternalServerException + attr_accessor message: ::String + SENSITIVE: [] + end + + class ListConfigurationManagersInput + attr_accessor filters: ::Array[Types::Filter] + attr_accessor max_items: ::Integer + attr_accessor starting_token: ::String + SENSITIVE: [] + end + + class ListConfigurationManagersOutput + attr_accessor configuration_managers_list: ::Array[Types::ConfigurationManagerSummary] + attr_accessor next_token: ::String + SENSITIVE: [] + end + + class ListQuickSetupTypesOutput + attr_accessor quick_setup_type_list: ::Array[Types::QuickSetupTypeOutput] + SENSITIVE: [] + end + + class ListTagsForResourceRequest + attr_accessor resource_arn: ::String + SENSITIVE: [] + end + + class ListTagsForResourceResponse + attr_accessor tags: ::Array[Types::TagEntry] + SENSITIVE: [:tags] + end + + class QuickSetupTypeOutput + attr_accessor latest_version: ::String + attr_accessor type: ::String + SENSITIVE: [] + end + + class ResourceNotFoundException + attr_accessor message: ::String + SENSITIVE: [] + end + + class ServiceSettings + attr_accessor explorer_enabling_role_arn: ::String + SENSITIVE: [] + end + + class StatusSummary + attr_accessor last_updated_at: ::Time + attr_accessor status: ("INITIALIZING" | "DEPLOYING" | "SUCCEEDED" | "DELETING" | "STOPPING" | "FAILED" | "STOPPED" | "DELETE_FAILED" | "STOP_FAILED" | "NONE") + attr_accessor status_details: ::Hash[::String, ::String] + attr_accessor status_message: ::String + attr_accessor status_type: ("Deployment" | "AsyncExecutions") + SENSITIVE: [] + end + + class TagEntry + attr_accessor key: ::String + attr_accessor value: ::String + SENSITIVE: [] + end + + class TagResourceInput + attr_accessor resource_arn: ::String + attr_accessor tags: ::Hash[::String, ::String] + SENSITIVE: [:tags] + end + + class ThrottlingException + attr_accessor message: ::String + SENSITIVE: [] + end + + class UntagResourceInput + attr_accessor resource_arn: ::String + attr_accessor tag_keys: ::Array[::String] + SENSITIVE: [] + end + + class UpdateConfigurationDefinitionInput + attr_accessor id: ::String + attr_accessor local_deployment_administration_role_arn: ::String + attr_accessor local_deployment_execution_role_name: ::String + attr_accessor manager_arn: ::String + attr_accessor parameters: ::Hash[::String, ::String] + attr_accessor type_version: ::String + SENSITIVE: [] + end + + class UpdateConfigurationManagerInput + attr_accessor description: ::String + attr_accessor manager_arn: ::String + attr_accessor name: ::String + SENSITIVE: [] + end + + class UpdateServiceSettingsInput + attr_accessor explorer_enabling_role_arn: ::String + SENSITIVE: [] + end + + class ValidationException + attr_accessor message: ::String + SENSITIVE: [] + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/sig/waiters.rbs b/gems/aws-sdk-ssmquicksetup/sig/waiters.rbs new file mode 100644 index 00000000000..ebf98757516 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/sig/waiters.rbs @@ -0,0 +1,13 @@ +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +module Aws + module SSMQuickSetup + module Waiters + end + end +end diff --git a/gems/aws-sdk-ssmquicksetup/spec/endpoint_provider_spec.rb b/gems/aws-sdk-ssmquicksetup/spec/endpoint_provider_spec.rb new file mode 100644 index 00000000000..510f43a35e0 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/spec/endpoint_provider_spec.rb @@ -0,0 +1,361 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + + +require_relative 'spec_helper' + +module Aws::SSMQuickSetup + describe EndpointProvider do + subject { Aws::SSMQuickSetup::EndpointProvider.new } + + context 'For region us-east-1 with FIPS enabled and DualStack enabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.us-east-1.api.aws"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-east-1", :use_fips=>true, :use_dual_stack=>true}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-east-1 with FIPS enabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.us-east-1.amazonaws.com"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-east-1", :use_fips=>true, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-east-1 with FIPS disabled and DualStack enabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.us-east-1.api.aws"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-east-1", :use_fips=>false, :use_dual_stack=>true}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-east-1 with FIPS disabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.us-east-1.amazonaws.com"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-east-1", :use_fips=>false, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region cn-north-1 with FIPS enabled and DualStack enabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.cn-north-1.api.amazonwebservices.com.cn"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"cn-north-1", :use_fips=>true, :use_dual_stack=>true}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region cn-north-1 with FIPS enabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.cn-north-1.amazonaws.com.cn"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"cn-north-1", :use_fips=>true, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region cn-north-1 with FIPS disabled and DualStack enabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.cn-north-1.api.amazonwebservices.com.cn"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"cn-north-1", :use_fips=>false, :use_dual_stack=>true}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region cn-north-1 with FIPS disabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.cn-north-1.amazonaws.com.cn"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"cn-north-1", :use_fips=>false, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-gov-east-1 with FIPS enabled and DualStack enabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.us-gov-east-1.api.aws"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-gov-east-1", :use_fips=>true, :use_dual_stack=>true}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-gov-east-1 with FIPS enabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.us-gov-east-1.amazonaws.com"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-gov-east-1", :use_fips=>true, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-gov-east-1 with FIPS disabled and DualStack enabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.us-gov-east-1.api.aws"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-gov-east-1", :use_fips=>false, :use_dual_stack=>true}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-gov-east-1 with FIPS disabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.us-gov-east-1.amazonaws.com"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-gov-east-1", :use_fips=>false, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-iso-east-1 with FIPS enabled and DualStack enabled' do + let(:expected) do + {"error"=>"FIPS and DualStack are enabled, but this partition does not support one or both"} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-iso-east-1", :use_fips=>true, :use_dual_stack=>true}) + expect do + subject.resolve_endpoint(params) + end.to raise_error(ArgumentError, expected['error']) + end + end + + context 'For region us-iso-east-1 with FIPS enabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.us-iso-east-1.c2s.ic.gov"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-iso-east-1", :use_fips=>true, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-iso-east-1 with FIPS disabled and DualStack enabled' do + let(:expected) do + {"error"=>"DualStack is enabled but this partition does not support DualStack"} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-iso-east-1", :use_fips=>false, :use_dual_stack=>true}) + expect do + subject.resolve_endpoint(params) + end.to raise_error(ArgumentError, expected['error']) + end + end + + context 'For region us-iso-east-1 with FIPS disabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.us-iso-east-1.c2s.ic.gov"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-iso-east-1", :use_fips=>false, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-isob-east-1 with FIPS enabled and DualStack enabled' do + let(:expected) do + {"error"=>"FIPS and DualStack are enabled, but this partition does not support one or both"} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-isob-east-1", :use_fips=>true, :use_dual_stack=>true}) + expect do + subject.resolve_endpoint(params) + end.to raise_error(ArgumentError, expected['error']) + end + end + + context 'For region us-isob-east-1 with FIPS enabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup-fips.us-isob-east-1.sc2s.sgov.gov"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-isob-east-1", :use_fips=>true, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For region us-isob-east-1 with FIPS disabled and DualStack enabled' do + let(:expected) do + {"error"=>"DualStack is enabled but this partition does not support DualStack"} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-isob-east-1", :use_fips=>false, :use_dual_stack=>true}) + expect do + subject.resolve_endpoint(params) + end.to raise_error(ArgumentError, expected['error']) + end + end + + context 'For region us-isob-east-1 with FIPS disabled and DualStack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://ssm-quicksetup.us-isob-east-1.sc2s.sgov.gov"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-isob-east-1", :use_fips=>false, :use_dual_stack=>false}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For custom endpoint with region set and fips disabled and dualstack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://example.com"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-east-1", :use_fips=>false, :use_dual_stack=>false, :endpoint=>"https://example.com"}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For custom endpoint with region not set and fips disabled and dualstack disabled' do + let(:expected) do + {"endpoint"=>{"url"=>"https://example.com"}} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:use_fips=>false, :use_dual_stack=>false, :endpoint=>"https://example.com"}) + endpoint = subject.resolve_endpoint(params) + expect(endpoint.url).to eq(expected['endpoint']['url']) + expect(endpoint.headers).to eq(expected['endpoint']['headers'] || {}) + expect(endpoint.properties).to eq(expected['endpoint']['properties'] || {}) + end + end + + context 'For custom endpoint with fips enabled and dualstack disabled' do + let(:expected) do + {"error"=>"Invalid Configuration: FIPS and custom endpoint are not supported"} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-east-1", :use_fips=>true, :use_dual_stack=>false, :endpoint=>"https://example.com"}) + expect do + subject.resolve_endpoint(params) + end.to raise_error(ArgumentError, expected['error']) + end + end + + context 'For custom endpoint with fips disabled and dualstack enabled' do + let(:expected) do + {"error"=>"Invalid Configuration: Dualstack and custom endpoint are not supported"} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{:region=>"us-east-1", :use_fips=>false, :use_dual_stack=>true, :endpoint=>"https://example.com"}) + expect do + subject.resolve_endpoint(params) + end.to raise_error(ArgumentError, expected['error']) + end + end + + context 'Missing region' do + let(:expected) do + {"error"=>"Invalid Configuration: Missing Region"} + end + + it 'produces the expected output from the EndpointProvider' do + params = EndpointParameters.new(**{}) + expect do + subject.resolve_endpoint(params) + end.to raise_error(ArgumentError, expected['error']) + end + end + + end +end diff --git a/gems/aws-sdk-ssmquicksetup/spec/spec_helper.rb b/gems/aws-sdk-ssmquicksetup/spec/spec_helper.rb new file mode 100644 index 00000000000..f067493c8f0 --- /dev/null +++ b/gems/aws-sdk-ssmquicksetup/spec/spec_helper.rb @@ -0,0 +1,18 @@ +# frozen_string_literal: true + +# WARNING ABOUT GENERATED CODE +# +# This file is generated. See the contributing guide for more information: +# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md +# +# WARNING ABOUT GENERATED CODE + +require_relative '../../aws-sdk-core/spec/shared_spec_helper' + +$:.unshift(File.expand_path('../../lib', __FILE__)) +$:.unshift(File.expand_path('../../../aws-sdk-core/lib', __FILE__)) +$:.unshift(File.expand_path('../../../aws-sigv4/lib', __FILE__)) + +require 'rspec' +require 'webmock/rspec' +require 'aws-sdk-ssmquicksetup' diff --git a/gems/aws-sdk-support/CHANGELOG.md b/gems/aws-sdk-support/CHANGELOG.md index e453c403304..fa2c2c78027 100644 --- a/gems/aws-sdk-support/CHANGELOG.md +++ b/gems/aws-sdk-support/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.64.0 (2024-08-01) +------------------ + +* Feature - Doc only updates to CaseDetails + 1.63.0 (2024-07-02) ------------------ diff --git a/gems/aws-sdk-support/VERSION b/gems/aws-sdk-support/VERSION index af92bdd9f58..9405730420f 100644 --- a/gems/aws-sdk-support/VERSION +++ b/gems/aws-sdk-support/VERSION @@ -1 +1 @@ -1.63.0 +1.64.0 diff --git a/gems/aws-sdk-support/lib/aws-sdk-support.rb b/gems/aws-sdk-support/lib/aws-sdk-support.rb index 1752eb3ac9b..e41dd929c6c 100644 --- a/gems/aws-sdk-support/lib/aws-sdk-support.rb +++ b/gems/aws-sdk-support/lib/aws-sdk-support.rb @@ -52,6 +52,6 @@ # @!group service module Aws::Support - GEM_VERSION = '1.63.0' + GEM_VERSION = '1.64.0' end diff --git a/gems/aws-sdk-support/lib/aws-sdk-support/client.rb b/gems/aws-sdk-support/lib/aws-sdk-support/client.rb index f5ac08c0900..cabea805ba9 100644 --- a/gems/aws-sdk-support/lib/aws-sdk-support/client.rb +++ b/gems/aws-sdk-support/lib/aws-sdk-support/client.rb @@ -1700,7 +1700,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-support' - context[:gem_version] = '1.63.0' + context[:gem_version] = '1.64.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-support/lib/aws-sdk-support/types.rb b/gems/aws-sdk-support/lib/aws-sdk-support/types.rb index 53b04350240..531ee08e4a2 100644 --- a/gems/aws-sdk-support/lib/aws-sdk-support/types.rb +++ b/gems/aws-sdk-support/lib/aws-sdk-support/types.rb @@ -107,7 +107,9 @@ class AddCommunicationToCaseResponse < Struct.new( end # An attachment to a case communication. The attachment consists of the - # file name and the content of the file. + # file name and the content of the file. Each attachment file size + # should not exceed 5 MB. File types that are supported include the + # following: pdf, jpeg,.doc, .log, .text # # @!attribute [rw] file_name # The name of the attachment file. @@ -277,6 +279,10 @@ class CaseCreationLimitExceeded < Struct.new( # * **status** - The status of the case in the Amazon Web Services # Support Center. Valid values: # + # * `all-open` + # + # * `customer-action-completed` + # # * `opened` # # * `pending-customer-action` @@ -317,6 +323,10 @@ class CaseCreationLimitExceeded < Struct.new( # # Valid values: # + # * `all-open` + # + # * `customer-action-completed` + # # * `opened` # # * `pending-customer-action` diff --git a/services.json b/services.json index 4ad415abe08..09760ca3ae3 100644 --- a/services.json +++ b/services.json @@ -1069,6 +1069,9 @@ "SSMIncidents": { "models": "ssm-incidents/2018-05-10" }, + "SSMQuickSetup": { + "models": "ssm-quicksetup/2018-05-10" + }, "SSO": { "models": "sso/2019-06-10", "gemName": "aws-sdk-core" diff --git a/tasks/benchmark b/tasks/benchmark deleted file mode 160000 index f3d048c1b5c..00000000000 --- a/tasks/benchmark +++ /dev/null @@ -1 +0,0 @@ -Subproject commit f3d048c1b5c94b4a017756a38783557728c3aca7