diff --git a/.changes/1.34.152.json b/.changes/1.34.152.json new file mode 100644 index 0000000000..5b8075bf57 --- /dev/null +++ b/.changes/1.34.152.json @@ -0,0 +1,47 @@ +[ + { + "category": "``bedrock``", + "description": "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.", + "type": "api-change" + }, + { + "category": "``controlcatalog``", + "description": "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.", + "type": "api-change" + }, + { + "category": "``controltower``", + "description": "Updated Control Tower service documentation for controlcatalog control ARN support with existing Control Tower public APIs", + "type": "api-change" + }, + { + "category": "``iam``", + "description": "Add v2 smoke tests and smithy smokeTests trait for SDK testing.", + "type": "api-change" + }, + { + "category": "``memorydb``", + "description": "Doc only update for changes to deletion API.", + "type": "api-change" + }, + { + "category": "``rds``", + "description": "This release adds support for specifying optional MinACU parameter in CreateDBShardGroup and ModifyDBShardGroup API. DBShardGroup response will contain MinACU if specified.", + "type": "api-change" + }, + { + "category": "``sagemaker``", + "description": "This release adds support for Amazon EMR Serverless applications in SageMaker Studio for running data processing jobs.", + "type": "api-change" + }, + { + "category": "``ssm-quicksetup``", + "description": "This release adds API support for the QuickSetup feature of AWS Systems Manager", + "type": "api-change" + }, + { + "category": "``support``", + "description": "Doc only updates to CaseDetails", + "type": "api-change" + } +] \ No newline at end of file diff --git a/CHANGELOG.rst b/CHANGELOG.rst index e71d7c2b21..ec85cb8a52 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -2,6 +2,20 @@ CHANGELOG ========= +1.34.152 +======== + +* api-change:``bedrock``: 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. +* api-change:``controlcatalog``: 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. +* api-change:``controltower``: Updated Control Tower service documentation for controlcatalog control ARN support with existing Control Tower public APIs +* api-change:``iam``: Add v2 smoke tests and smithy smokeTests trait for SDK testing. +* api-change:``memorydb``: Doc only update for changes to deletion API. +* api-change:``rds``: This release adds support for specifying optional MinACU parameter in CreateDBShardGroup and ModifyDBShardGroup API. DBShardGroup response will contain MinACU if specified. +* api-change:``sagemaker``: This release adds support for Amazon EMR Serverless applications in SageMaker Studio for running data processing jobs. +* api-change:``ssm-quicksetup``: This release adds API support for the QuickSetup feature of AWS Systems Manager +* api-change:``support``: Doc only updates to CaseDetails + + 1.34.151 ======== diff --git a/botocore/__init__.py b/botocore/__init__.py index 760eb17ed1..bbaf19578a 100644 --- a/botocore/__init__.py +++ b/botocore/__init__.py @@ -16,7 +16,7 @@ import os import re -__version__ = '1.34.151' +__version__ = '1.34.152' class NullHandler(logging.Handler): diff --git a/botocore/data/bedrock/2023-04-20/paginators-1.json b/botocore/data/bedrock/2023-04-20/paginators-1.json index f9017e8619..8d49059e7c 100644 --- a/botocore/data/bedrock/2023-04-20/paginators-1.json +++ b/botocore/data/bedrock/2023-04-20/paginators-1.json @@ -29,6 +29,12 @@ "output_token": "nextToken", "limit_key": "maxResults", "result_key": "guardrails" + }, + "ListModelCopyJobs": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "modelCopyJobSummaries" } } } diff --git a/botocore/data/bedrock/2023-04-20/service-2.json b/botocore/data/bedrock/2023-04-20/service-2.json index 5e955e8373..03c4c77137 100644 --- a/botocore/data/bedrock/2023-04-20/service-2.json +++ b/botocore/data/bedrock/2023-04-20/service-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", @@ -30,7 +31,7 @@ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], - "documentation":"
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.
", + "documentation":"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.
", "idempotent":true }, "CreateGuardrail":{ @@ -74,6 +75,24 @@ ], "documentation":"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.
" }, + "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"} + ], + "documentation":"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.
", + "idempotent":true + }, "CreateModelCustomizationJob":{ "name":"CreateModelCustomizationJob", "http":{ @@ -93,7 +112,7 @@ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
", + "documentation":"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.
", "idempotent":true }, "CreateProvisionedModelThroughput":{ @@ -114,7 +133,7 @@ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
", + "documentation":"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.
", "idempotent":true }, "DeleteCustomModel":{ @@ -134,7 +153,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"Deletes a custom model that you created earlier. For more information, see Custom models in the Amazon Bedrock User Guide.
", + "documentation":"Deletes a custom model that you created earlier. For more information, see Custom models in the Amazon Bedrock User Guide.
", "idempotent":true }, "DeleteGuardrail":{ @@ -191,7 +210,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
", + "documentation":"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.
", "idempotent":true }, "GetCustomModel":{ @@ -210,7 +229,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
" + "documentation":"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":{ "name":"GetEvaluationJob", @@ -228,7 +247,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"Retrieves the properties associated with a model evaluation job, including the status of the job. For more information, see Model evaluations.
" + "documentation":"Retrieves the properties associated with a model evaluation job, including the status of the job. For more information, see Model evaluation.
" }, "GetFoundationModel":{ "name":"GetFoundationModel", @@ -266,6 +285,24 @@ ], "documentation":"Gets details about a guardrail. If you don't specify a version, the response returns details for the DRAFT
version.
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":{ "name":"GetModelCustomizationJob", "http":{ @@ -282,7 +319,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
" + "documentation":"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":{ "name":"GetModelInvocationLoggingConfiguration", @@ -316,7 +353,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"Returns details for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
" + "documentation":"Returns details for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
" }, "ListCustomModels":{ "name":"ListCustomModels", @@ -333,7 +370,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
" + "documentation":"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":{ "name":"ListEvaluationJobs", @@ -367,7 +404,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
" + "documentation":"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":{ "name":"ListGuardrails", @@ -387,6 +424,24 @@ ], "documentation":"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.
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":{ "name":"ListModelCustomizationJobs", "http":{ @@ -402,7 +457,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"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.
" + "documentation":"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":{ "name":"ListProvisionedModelThroughputs", @@ -419,7 +474,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"Lists the Provisioned Throughputs in the account. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
" + "documentation":"Lists the Provisioned Throughputs in the account. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
" }, "ListTagsForResource":{ "name":"ListTagsForResource", @@ -437,7 +492,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"List the tags associated with the specified resource.
For more information, see Tagging resources in the Amazon Bedrock User Guide.
" + "documentation":"List the tags associated with the specified resource.
For more information, see Tagging resources in the Amazon Bedrock User Guide.
" }, "PutModelInvocationLoggingConfiguration":{ "name":"PutModelInvocationLoggingConfiguration", @@ -493,7 +548,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"Stops an active model customization job. For more information, see Custom models in the Amazon Bedrock User Guide.
", + "documentation":"Stops an active model customization job. For more information, see Custom models in the Amazon Bedrock User Guide.
", "idempotent":true }, "TagResource":{ @@ -513,7 +568,7 @@ {"shape":"TooManyTagsException"}, {"shape":"ThrottlingException"} ], - "documentation":"Associate tags with a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.
" + "documentation":"Associate tags with a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.
" }, "UntagResource":{ "name":"UntagResource", @@ -531,7 +586,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"Remove one or more tags from a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.
" + "documentation":"Remove one or more tags from a resource. For more information, see Tagging resources in the Amazon Bedrock User Guide.
" }, "UpdateGuardrail":{ "name":"UpdateGuardrail", @@ -570,7 +625,7 @@ {"shape":"InternalServerException"}, {"shape":"ThrottlingException"} ], - "documentation":"Updates the name or associated model for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
", + "documentation":"Updates the name or associated model for a Provisioned Throughput. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
", "idempotent":true } }, @@ -587,6 +642,10 @@ }, "exception":true }, + "AccountId":{ + "type":"string", + "pattern":"[0-9]{12}" + }, "AutomatedEvaluationConfig":{ "type":"structure", "required":["datasetMetricConfigs"], @@ -849,6 +908,46 @@ } } }, + "CreateModelCopyJobRequest":{ + "type":"structure", + "required":[ + "sourceModelArn", + "targetModelName" + ], + "members":{ + "sourceModelArn":{ + "shape":"ModelArn", + "documentation":"The Amazon Resource Name (ARN) of the model to be copied.
" + }, + "targetModelName":{ + "shape":"CustomModelName", + "documentation":"A name for the copied model.
" + }, + "modelKmsKeyId":{ + "shape":"KmsKeyId", + "documentation":"The ARN of the KMS key that you use to encrypt the model copy.
" + }, + "targetModelTags":{ + "shape":"TagList", + "documentation":"Tags to associate with the target model. For more information, see Tag resources in the Amazon Bedrock User Guide.
" + }, + "clientRequestToken":{ + "shape":"IdempotencyToken", + "documentation":"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.
", + "idempotencyToken":true + } + } + }, + "CreateModelCopyJobResponse":{ + "type":"structure", + "required":["jobArn"], + "members":{ + "jobArn":{ + "shape":"ModelCopyJobArn", + "documentation":"The Amazon Resource Name (ARN) of the model copy job.
" + } + } + }, "CreateModelCustomizationJobRequest":{ "type":"structure", "required":[ @@ -945,7 +1044,7 @@ }, "modelUnits":{ "shape":"PositiveInteger", - "documentation":"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.
" + "documentation":"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.
" }, "provisionedModelName":{ "shape":"ProvisionedModelName", @@ -953,11 +1052,11 @@ }, "modelId":{ "shape":"ModelIdentifier", - "documentation":"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.
" + "documentation":"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.
" }, "commitmentDuration":{ "shape":"CommitmentDuration", - "documentation":"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
" + "documentation":"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
" }, "tags":{ "shape":"TagList", @@ -985,7 +1084,7 @@ "type":"string", "max":63, "min":1, - "pattern":"([0-9a-zA-Z][_-]?)+" + "pattern":"([0-9a-zA-Z][_-]?){1,63}" }, "CustomModelSummary":{ "type":"structure", @@ -1020,6 +1119,10 @@ "customizationType":{ "shape":"CustomizationType", "documentation":"Specifies whether to carry out continued pre-training of a model or whether to fine-tune it. For more information, see Custom models.
" + }, + "ownerAccountId":{ + "shape":"AccountId", + "documentation":"The unique identifier of the account that owns the model.
" } }, "documentation":"Summary information for a custom model.
" @@ -1827,6 +1930,75 @@ } } }, + "GetModelCopyJobRequest":{ + "type":"structure", + "required":["jobArn"], + "members":{ + "jobArn":{ + "shape":"ModelCopyJobArn", + "documentation":"The Amazon Resource Name (ARN) of the model copy job.
", + "location":"uri", + "locationName":"jobArn" + } + } + }, + "GetModelCopyJobResponse":{ + "type":"structure", + "required":[ + "jobArn", + "status", + "creationTime", + "targetModelArn", + "sourceAccountId", + "sourceModelArn" + ], + "members":{ + "jobArn":{ + "shape":"ModelCopyJobArn", + "documentation":"The Amazon Resource Name (ARN) of the model copy job.
" + }, + "status":{ + "shape":"ModelCopyJobStatus", + "documentation":"The status of the model copy job.
" + }, + "creationTime":{ + "shape":"Timestamp", + "documentation":"The time at which the model copy job was created.
" + }, + "targetModelArn":{ + "shape":"CustomModelArn", + "documentation":"The Amazon Resource Name (ARN) of the copied model.
" + }, + "targetModelName":{ + "shape":"CustomModelName", + "documentation":"The name of the copied model.
" + }, + "sourceAccountId":{ + "shape":"AccountId", + "documentation":"The unique identifier of the account that the model being copied originated from.
" + }, + "sourceModelArn":{ + "shape":"ModelArn", + "documentation":"The Amazon Resource Name (ARN) of the original model being copied.
" + }, + "targetModelKmsKeyArn":{ + "shape":"KmsKeyArn", + "documentation":"The Amazon Resource Name (ARN) of the KMS key encrypting the copied model.
" + }, + "targetModelTags":{ + "shape":"TagList", + "documentation":"The tags associated with the copied model.
" + }, + "failureMessage":{ + "shape":"ErrorMessage", + "documentation":"An error message for why the model copy job failed.
" + }, + "sourceModelName":{ + "shape":"CustomModelName", + "documentation":"The name of the original model being copied.
" + } + } + }, "GetModelCustomizationJobRequest":{ "type":"structure", "required":["jobIdentifier"], @@ -2331,7 +2503,7 @@ "members":{ "type":{ "shape":"GuardrailPiiEntityType", - "documentation":"The type of PII entity. For example, Social Security Number.
" + "documentation":"The type of PII entity. For exampvle, Social Security Number.
" }, "action":{ "shape":"GuardrailSensitiveInformationAction", @@ -2945,13 +3117,13 @@ }, "maxResults":{ "shape":"MaxResults", - "documentation":"Maximum number of results to return in the response.
", + "documentation":"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.
Continuation token from the previous response, for Amazon Bedrock to list the next set of results.
", + "documentation":"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.
The sort order of the results.
", "location":"querystring", "locationName":"sortOrder" + }, + "isOwned":{ + "shape":"Boolean", + "documentation":"Return custom models depending on if the current account owns them (true
) or if they were shared with the current account (false
).
Continuation token for the next request to list the next set of results.
" + "documentation":"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 models that support the customization type that you specify. For more information, see Custom models in the Amazon Bedrock User Guide.
", + "documentation":"Return models that support the customization type that you specify. For more information, see Custom models in the Amazon Bedrock User Guide.
", "location":"querystring", "locationName":"byCustomizationType" }, @@ -3071,7 +3249,7 @@ }, "byInferenceType":{ "shape":"InferenceType", - "documentation":"Return models that support the inference type that you specify. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
", + "documentation":"Return models that support the inference type that you specify. For more information, see Provisioned Throughput in the Amazon Bedrock User Guide.
", "location":"querystring", "locationName":"byInferenceType" } @@ -3123,6 +3301,84 @@ } } }, + "ListModelCopyJobsRequest":{ + "type":"structure", + "members":{ + "creationTimeAfter":{ + "shape":"Timestamp", + "documentation":"Filters for model copy jobs created after the specified time.
", + "location":"querystring", + "locationName":"creationTimeAfter" + }, + "creationTimeBefore":{ + "shape":"Timestamp", + "documentation":"Filters for model copy jobs created before the specified time.
", + "location":"querystring", + "locationName":"creationTimeBefore" + }, + "statusEquals":{ + "shape":"ModelCopyJobStatus", + "documentation":"Filters for model copy jobs whose status matches the value that you specify.
", + "location":"querystring", + "locationName":"statusEquals" + }, + "sourceAccountEquals":{ + "shape":"AccountId", + "documentation":"Filters for model copy jobs in which the account that the source model belongs to is equal to the value that you specify.
", + "location":"querystring", + "locationName":"sourceAccountEquals" + }, + "sourceModelArnEquals":{ + "shape":"ModelArn", + "documentation":"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.
", + "location":"querystring", + "locationName":"sourceModelArnEquals" + }, + "targetModelNameContains":{ + "shape":"CustomModelName", + "documentation":"Filters for model copy jobs in which the name of the copied model contains the string that you specify.
", + "location":"querystring", + "locationName":"outputModelNameContains" + }, + "maxResults":{ + "shape":"MaxResults", + "documentation":"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.
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.
The field to sort by in the returned list of model copy jobs.
", + "location":"querystring", + "locationName":"sortBy" + }, + "sortOrder":{ + "shape":"SortOrder", + "documentation":"Specifies whether to sort the results in ascending or descending order.
", + "location":"querystring", + "locationName":"sortOrder" + } + } + }, + "ListModelCopyJobsResponse":{ + "type":"structure", + "members":{ + "nextToken":{ + "shape":"PaginationToken", + "documentation":"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.
A list of information about each model copy job.
" + } + } + }, "ListModelCustomizationJobsRequest":{ "type":"structure", "members":{ @@ -3152,13 +3408,13 @@ }, "maxResults":{ "shape":"MaxResults", - "documentation":"Maximum number of results to return in the response.
", + "documentation":"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.
Continuation token from the previous response, for Amazon Bedrock to list the next set of results.
", + "documentation":"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.
Page continuation token to use in the next request.
" + "documentation":"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.
The Amazon Resoource Name (ARN) of the model copy job.
" + }, + "status":{ + "shape":"ModelCopyJobStatus", + "documentation":"The status of the model copy job.
" + }, + "creationTime":{ + "shape":"Timestamp", + "documentation":"The time that the model copy job was created.
" + }, + "targetModelArn":{ + "shape":"CustomModelArn", + "documentation":"The Amazon Resource Name (ARN) of the copied model.
" + }, + "targetModelName":{ + "shape":"CustomModelName", + "documentation":"The name of the copied model.
" + }, + "sourceAccountId":{ + "shape":"AccountId", + "documentation":"The unique identifier of the account that the model being copied originated from.
" + }, + "sourceModelArn":{ + "shape":"ModelArn", + "documentation":"The Amazon Resource Name (ARN) of the original model being copied.
" + }, + "targetModelKmsKeyArn":{ + "shape":"KmsKeyArn", + "documentation":"The Amazon Resource Name (ARN) of the KMS key used to encrypt the copied model.
" + }, + "targetModelTags":{ + "shape":"TagList", + "documentation":"Tags associated with the copied model.
" + }, + "failureMessage":{ + "shape":"ErrorMessage", + "documentation":"If a model fails to be copied, a message describing why the job failed is included here.
" + }, + "sourceModelName":{ + "shape":"CustomModelName", + "documentation":"The name of the original model being copied.
" + } + }, + "documentation":"Contains details about each model copy job.
This data type is used in the following API operations:
" + }, "ModelCustomization":{ "type":"string", "enum":[ diff --git a/botocore/data/controlcatalog/2018-05-10/paginators-1.json b/botocore/data/controlcatalog/2018-05-10/paginators-1.json index d716b3dcef..1926666e8c 100644 --- a/botocore/data/controlcatalog/2018-05-10/paginators-1.json +++ b/botocore/data/controlcatalog/2018-05-10/paginators-1.json @@ -17,6 +17,12 @@ "output_token": "NextToken", "limit_key": "MaxResults", "result_key": "Objectives" + }, + "ListControls": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "Controls" } } } diff --git a/botocore/data/controlcatalog/2018-05-10/service-2.json b/botocore/data/controlcatalog/2018-05-10/service-2.json index 9c1a84c3ee..5dc6c918de 100644 --- a/botocore/data/controlcatalog/2018-05-10/service-2.json +++ b/botocore/data/controlcatalog/2018-05-10/service-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,24 @@ "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"} + ], + "documentation":"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.
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":{ + "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"} + ], + "documentation":"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":{ "name":"ListDomains", "http":{ @@ -109,7 +145,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", @@ -125,21 +161,21 @@ "type":"structure", "required":[ "Arn", - "CreateTime", + "Name", "Description", "Domain", - "LastUpdateTime", - "Name", - "Objective" + "Objective", + "CreateTime", + "LastUpdateTime" ], "members":{ "Arn":{ "shape":"CommonControlArn", "documentation":"The Amazon Resource Name (ARN) that identifies the common control.
" }, - "CreateTime":{ - "shape":"Timestamp", - "documentation":"The time when the common control was created.
" + "Name":{ + "shape":"String", + "documentation":"The name of the common control.
" }, "Description":{ "shape":"String", @@ -149,30 +185,82 @@ "shape":"AssociatedDomainSummary", "documentation":"The domain that the common control belongs to.
" }, + "Objective":{ + "shape":"AssociatedObjectiveSummary", + "documentation":"The objective that the common control belongs to.
" + }, + "CreateTime":{ + "shape":"Timestamp", + "documentation":"The time when the common control was created.
" + }, "LastUpdateTime":{ "shape":"Timestamp", "documentation":"The time when the common control was most recently updated.
" + } + }, + "documentation":"A summary of metadata for a common control.
" + }, + "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", + "documentation":"The Amazon Resource Name (ARN) of the control.
" }, "Name":{ "shape":"String", - "documentation":"The name of the common control.
" + "documentation":"The display name of the control.
" }, - "Objective":{ - "shape":"AssociatedObjectiveSummary", - "documentation":"The objective that the common control belongs to.
" + "Description":{ + "shape":"String", + "documentation":"A description of the control, as it may appear in the console. Describes the functionality of the control.
" } }, - "documentation":"A summary of metadata for a common control.
" + "documentation":"Overview of information about a control.
" }, - "CommonControlSummaryList":{ + "Controls":{ "type":"list", - "member":{"shape":"CommonControlSummary"} + "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", @@ -192,31 +280,31 @@ "type":"structure", "required":[ "Arn", - "CreateTime", + "Name", "Description", - "LastUpdateTime", - "Name" + "CreateTime", + "LastUpdateTime" ], "members":{ "Arn":{ "shape":"DomainArn", "documentation":"The Amazon Resource Name (ARN) that identifies the domain.
" }, - "CreateTime":{ - "shape":"Timestamp", - "documentation":"The time when the domain was created.
" + "Name":{ + "shape":"String", + "documentation":"The name of the domain.
" }, "Description":{ "shape":"String", "documentation":"The description of the domain.
" }, + "CreateTime":{ + "shape":"Timestamp", + "documentation":"The time when the domain was created.
" + }, "LastUpdateTime":{ "shape":"Timestamp", "documentation":"The time when the domain was most recently updated.
" - }, - "Name":{ - "shape":"String", - "documentation":"The name of the domain.
" } }, "documentation":"A summary of metadata for a domain.
" @@ -225,6 +313,45 @@ "type":"list", "member":{"shape":"DomainSummary"} }, + "GetControlRequest":{ + "type":"structure", + "required":["ControlArn"], + "members":{ + "ControlArn":{ + "shape":"ControlArn", + "documentation":"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_\\\\-]+$
The Amazon Resource Name (ARN) of the control.
" + }, + "Name":{ + "shape":"String", + "documentation":"The display name of the control.
" + }, + "Description":{ + "shape":"String", + "documentation":"A description of what the control does.
" + }, + "Behavior":{ + "shape":"ControlBehavior", + "documentation":"A term that identifies the control's functional behavior. One of Preventive
, Deteictive
, Proactive
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.
The maximum number of results on a page or for an API request call.
", @@ -254,6 +377,10 @@ "documentation":"The pagination token that's used to fetch the next set of results.
", "location":"querystring", "locationName":"nextToken" + }, + "CommonControlFilter":{ + "shape":"CommonControlFilter", + "documentation":"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.
The pagination token that's used to fetch the next set of results.
", + "location":"querystring", + "locationName":"nextToken" + }, + "MaxResults":{ + "shape":"MaxListControlsResults", + "documentation":"The maximum number of results on a page or for an API request call.
", + "location":"querystring", + "locationName":"maxResults" + } + } + }, + "ListControlsResponse":{ + "type":"structure", + "required":["Controls"], + "members":{ + "Controls":{ + "shape":"Controls", + "documentation":"Returns a list of controls, given as structures of type controlSummary.
" + }, + "NextToken":{ + "shape":"PaginationToken", + "documentation":"The pagination token that's used to fetch the next set of results.
" + } + } + }, "ListDomainsRequest":{ "type":"structure", "members":{ @@ -327,13 +485,13 @@ "type":"structure", "required":["Objectives"], "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"The pagination token that's used to fetch the next set of results.
" - }, "Objectives":{ "shape":"ObjectiveSummaryList", "documentation":"The list of objectives that the ListObjectives
API returns.
The pagination token that's used to fetch the next set of results.
" } } }, @@ -343,6 +501,12 @@ "max":100, "min":1 }, + "MaxListControlsResults":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, "MaxListDomainsResults":{ "type":"integer", "box":true, @@ -359,7 +523,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", @@ -389,20 +553,20 @@ "type":"structure", "required":[ "Arn", - "CreateTime", + "Name", "Description", "Domain", - "LastUpdateTime", - "Name" + "CreateTime", + "LastUpdateTime" ], "members":{ "Arn":{ "shape":"ObjectiveArn", "documentation":"The Amazon Resource Name (ARN) that identifies the objective.
" }, - "CreateTime":{ - "shape":"Timestamp", - "documentation":"The time when the objective was created.
" + "Name":{ + "shape":"String", + "documentation":"The name of the objective.
" }, "Description":{ "shape":"String", @@ -412,13 +576,13 @@ "shape":"AssociatedDomainSummary", "documentation":"The domain that the objective belongs to.
" }, + "CreateTime":{ + "shape":"Timestamp", + "documentation":"The time when the objective was created.
" + }, "LastUpdateTime":{ "shape":"Timestamp", "documentation":"The time when the objective was most recently updated.
" - }, - "Name":{ - "shape":"String", - "documentation":"The name of the objective.
" } }, "documentation":"A summary of metadata for an objective.
" @@ -432,6 +596,37 @@ "max":1024, "min":0 }, + "RegionCode":{ + "type":"string", + "pattern":"[a-zA-Z0-9-]{1,128}" + }, + "RegionConfiguration":{ + "type":"structure", + "required":["Scope"], + "members":{ + "Scope":{ + "shape":"ControlScope", + "documentation":"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.
Regions in which the control is available to be deployed.
" + } + }, + "documentation":"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.
The requested resource does not exist.
", + "error":{ + "httpStatusCode":404, + "senderFault":true + }, + "exception":true + }, "String":{"type":"string"}, "ThrottlingException":{ "type":"structure", diff --git a/botocore/data/controlcatalog/2018-05-10/waiters-2.json b/botocore/data/controlcatalog/2018-05-10/waiters-2.json new file mode 100644 index 0000000000..13f60ee66b --- /dev/null +++ b/botocore/data/controlcatalog/2018-05-10/waiters-2.json @@ -0,0 +1,5 @@ +{ + "version": 2, + "waiters": { + } +} diff --git a/botocore/data/controltower/2018-05-10/service-2.json b/botocore/data/controltower/2018-05-10/service-2.json index b805e91d40..c3785ddbd1 100644 --- a/botocore/data/controltower/2018-05-10/service-2.json +++ b/botocore/data/controltower/2018-05-10/service-2.json @@ -2216,5 +2216,5 @@ "exception":true } }, - "documentation":"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:
the controlIdentifier
for the control--or guardrail--you are targeting.
the ARN associated with the target organizational unit (OU), which we call the targetIdentifier
.
the ARN associated with a resource that you wish to tag or untag.
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.
" + "documentation":"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:
the controlIdentifier
for the control--or guardrail--you are targeting.
the ARN associated with the target organizational unit (OU), which we call the targetIdentifier
.
the ARN associated with a resource that you wish to tag or untag.
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
ARN format for Amazon Web Services Control Tower: arn:aws:controltower:{REGION}::control/{CONTROL_TOWER_OPAQUE_ID}
Example:
arn:aws:controltower:us-west-2::control/AWS-GR_AUTOSCALING_LAUNCH_CONFIG_PUBLIC_IP_DISABLED
ARN format for Amazon Web Services Control Catalog: arn:{PARTITION}:controlcatalog:::control/{CONTROL_CATALOG_OPAQUE_ID}
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
The EnableControl
and DisableControl
API operations can be called by specifying either the Amazon Web Services Control Tower identifer or the Amazon Web Services Control Catalog identifier. The API response returns the same type of identifier that you specified when calling the API.
If you use an Amazon Web Services Control Tower identifier to call the EnableControl
API, and then call EnableControl
again with an Amazon Web Services Control Catalog identifier, Amazon Web Services Control Tower returns an error message stating that the control is already enabled. Similar behavior applies to the DisableControl
API operation.
Mandatory controls and the landing-zone-level Region deny control have Amazon Web Services Control Tower identifiers only.
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.
" } diff --git a/botocore/data/iam/2010-05-08/service-2.json b/botocore/data/iam/2010-05-08/service-2.json index b234fae85f..fb62d66f2c 100644 --- a/botocore/data/iam/2010-05-08/service-2.json +++ b/botocore/data/iam/2010-05-08/service-2.json @@ -5,12 +5,14 @@ "endpointPrefix":"iam", "globalEndpoint":"iam.amazonaws.com", "protocol":"query", + "protocols":["query"], "serviceAbbreviation":"IAM", "serviceFullName":"AWS Identity and Access Management", "serviceId":"IAM", "signatureVersion":"v4", "uid":"iam-2010-05-08", - "xmlNamespace":"https://iam.amazonaws.com/doc/2010-05-08/" + "xmlNamespace":"https://iam.amazonaws.com/doc/2010-05-08/", + "auth":["aws.auth#sigv4"] }, "operations":{ "AddClientIDToOpenIDConnectProvider":{ diff --git a/botocore/data/memorydb/2021-01-01/service-2.json b/botocore/data/memorydb/2021-01-01/service-2.json index 3c41fd3b8a..ec1558b0ec 100644 --- a/botocore/data/memorydb/2021-01-01/service-2.json +++ b/botocore/data/memorydb/2021-01-01/service-2.json @@ -204,7 +204,7 @@ {"shape":"InvalidParameterValueException"}, {"shape":"InvalidParameterCombinationException"} ], - "documentation":"Deletes a cluster. It also deletes all associated nodes and node endpoints
" + "documentation":"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.
The maximum capacity of the DB shard group in Aurora capacity units (ACUs).
" }, + "MinACU":{ + "shape":"DoubleOptional", + "documentation":"The minimum capacity of the DB shard group in Aurora capacity units (ACUs).
" + }, "PubliclyAccessible":{ "shape":"BooleanOptional", "documentation":"Specifies 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 is not 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.
Default: The default behavior varies depending on whether DBSubnetGroupName
is specified.
If DBSubnetGroupName
isn't specified, and PubliclyAccessible
isn't specified, the following applies:
If the default VPC in the target Region doesn’t have an internet gateway attached to it, the DB shard group is private.
If the default VPC in the target Region has an internet gateway attached to it, the DB shard group is public.
If DBSubnetGroupName
is specified, and PubliclyAccessible
isn't specified, the following applies:
If the subnets are part of a VPC that doesn’t have an internet gateway attached to it, the DB shard group is private.
If the subnets are part of a VPC that has an internet gateway attached to it, the DB shard group is public.
The maximum capacity of the DB shard group in Aurora capacity units (ACUs).
" }, + "MinACU":{ + "shape":"DoubleOptional", + "documentation":"The minimum capacity of the DB shard group in Aurora capacity units (ACUs).
" + }, "ComputeRedundancy":{ "shape":"IntegerOptional", "documentation":"Specifies whether to create standby instances for the DB shard group. Valid values are the following:
0 - Creates a single, primary DB instance for each physical shard. This is the default value, and the only one supported for the preview.
1 - Creates a primary DB instance and a standby instance in a different Availability Zone (AZ) for each physical shard.
2 - Creates a primary DB instance and two standby instances in different AZs for each physical shard.
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.
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.
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:
Must be 1 to 255 letters, numbers, or hyphens.
First character must be a letter
Can't end with a hyphen or contain two consecutive hyphens
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:
Must be 1 to 255 letters, numbers, or hyphens.
First character must be a letter
Can't end with a hyphen or contain two consecutive hyphens
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.
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.
" } }, "documentation":"" @@ -9182,7 +9190,7 @@ }, "Source":{ "shape":"String", - "documentation":"A specific source to return parameters for.
Valid Values:
user
engine
service
A specific source to return parameters for.
Valid Values:
customer
engine
service
The maximum capacity of the DB shard group in Aurora capacity units (ACUs).
" + }, + "MinACU":{ + "shape":"DoubleOptional", + "documentation":"The minimum capacity of the DB shard group in Aurora capacity units (ACUs).
" } } }, @@ -13146,18 +13158,18 @@ }, "DBSecurityGroupMemberships":{ "shape":"DBSecurityGroupNameList", - "documentation":"A list of DBSecurityGroupMembership name strings used for this option.
" + "documentation":"A list of DB security groups used for this option.
" }, "VpcSecurityGroupMemberships":{ "shape":"VpcSecurityGroupIdList", - "documentation":"A list of VpcSecurityGroupMembership name strings used for this option.
" + "documentation":"A list of VPC security group names used for this option.
" }, "OptionSettings":{ "shape":"OptionSettingsList", "documentation":"The option settings to include in an option group.
" } }, - "documentation":"A list of all available options
" + "documentation":"A list of all available options for an option group.
" }, "OptionConfigurationList":{ "type":"list", @@ -16569,7 +16581,7 @@ "documentation":"A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can't be prefixed with aws:
or rds:
. The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-@]*)$\").
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.
" + "documentation":"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.
" }, "TagList":{ "type":"list", @@ -16577,7 +16589,7 @@ "shape":"Tag", "locationName":"Tag" }, - "documentation":"A list of tags. For more information, see Tagging Amazon RDS Resources in the Amazon RDS User Guide.
" + "documentation":"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.
" }, "TagListMessage":{ "type":"structure", diff --git a/botocore/data/sagemaker/2017-07-24/service-2.json b/botocore/data/sagemaker/2017-07-24/service-2.json index 87ea35704c..6c0d13beed 100644 --- a/botocore/data/sagemaker/2017-07-24/service-2.json +++ b/botocore/data/sagemaker/2017-07-24/service-2.json @@ -5173,6 +5173,11 @@ }, "documentation":"Lists a summary of the properties of an association. An association is an entity that links other lineage or experiment entities. An example would be an association between a training job and a model.
" }, + "AssumableRoleArns":{ + "type":"list", + "member":{"shape":"RoleArn"}, + "max":5 + }, "AsyncInferenceClientConfig":{ "type":"structure", "members":{ @@ -18006,6 +18011,20 @@ "max":10, "pattern":"\\d+" }, + "EmrSettings":{ + "type":"structure", + "members":{ + "AssumableRoleArns":{ + "shape":"AssumableRoleArns", + "documentation":"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.
" + }, + "ExecutionRoleArns":{ + "shape":"ExecutionRoleArns", + "documentation":"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.
" + } + }, + "documentation":"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":{"type":"boolean"}, "EnableInfraCheck":{"type":"boolean"}, "EnableIotRoleAlias":{"type":"boolean"}, @@ -18446,6 +18465,11 @@ "type":"string", "max":100 }, + "ExecutionRoleArns":{ + "type":"list", + "member":{"shape":"RoleArn"}, + "max":5 + }, "ExecutionRoleIdentityConfig":{ "type":"string", "enum":[ @@ -22122,6 +22146,10 @@ "CodeRepositories":{ "shape":"CodeRepositories", "documentation":"A list of Git repositories that SageMaker automatically displays to users for cloning in the JupyterLab application.
" + }, + "EmrSettings":{ + "shape":"EmrSettings", + "documentation":"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.
" } }, "documentation":"The settings for the JupyterLab application.
" diff --git a/botocore/data/ssm-quicksetup/2018-05-10/endpoint-rule-set-1.json b/botocore/data/ssm-quicksetup/2018-05-10/endpoint-rule-set-1.json new file mode 100644 index 0000000000..31c96c7c39 --- /dev/null +++ b/botocore/data/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/botocore/data/ssm-quicksetup/2018-05-10/paginators-1.json b/botocore/data/ssm-quicksetup/2018-05-10/paginators-1.json new file mode 100644 index 0000000000..da5d6c97f7 --- /dev/null +++ b/botocore/data/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/botocore/data/ssm-quicksetup/2018-05-10/service-2.json b/botocore/data/ssm-quicksetup/2018-05-10/service-2.json new file mode 100644 index 0000000000..7d0677cdca --- /dev/null +++ b/botocore/data/ssm-quicksetup/2018-05-10/service-2.json @@ -0,0 +1,997 @@ +{ + "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"} + ], + "documentation":"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":{ + "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"} + ], + "documentation":"Deletes a configuration manager.
", + "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"} + ], + "documentation":"Returns a configuration manager.
" + }, + "GetServiceSettings":{ + "name":"GetServiceSettings", + "http":{ + "method":"GET", + "requestUri":"/serviceSettings", + "responseCode":200 + }, + "output":{"shape":"GetServiceSettingsOutput"}, + "errors":[ + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"Returns settings configured for Quick Setup in the requesting Amazon Web Services account and Amazon Web Services Region.
" + }, + "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"} + ], + "documentation":"Returns Quick Setup configuration managers.
" + }, + "ListQuickSetupTypes":{ + "name":"ListQuickSetupTypes", + "http":{ + "method":"GET", + "requestUri":"/listQuickSetupTypes", + "responseCode":200 + }, + "output":{"shape":"ListQuickSetupTypesOutput"}, + "errors":[ + {"shape":"ConflictException"}, + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"Returns the available Quick Setup types.
" + }, + "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"} + ], + "documentation":"Returns tags assigned to the resource.
" + }, + "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"} + ], + "documentation":"Assigns key-value pairs of metadata to Amazon Web Services resources.
", + "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"} + ], + "documentation":"Removes tags from the specified resource.
", + "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"} + ], + "documentation":"Updates a Quick Setup configuration definition.
", + "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"} + ], + "documentation":"Updates a Quick Setup configuration manager.
", + "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"} + ], + "documentation":"Updates settings configured for Quick Setup.
", + "idempotent":true + } + }, + "shapes":{ + "AccessDeniedException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "documentation":"The requester has insufficient permissions to perform the operation.
", + "error":{ + "httpStatusCode":403, + "senderFault":true + }, + "exception":true + }, + "ConfigurationDefinition":{ + "type":"structure", + "required":[ + "Parameters", + "Type" + ], + "members":{ + "Id":{ + "shape":"String", + "documentation":"The ID of the configuration definition.
" + }, + "LocalDeploymentAdministrationRoleArn":{ + "shape":"IAMRoleArn", + "documentation":"The ARN of the IAM role used to administrate local configuration deployments.
" + }, + "LocalDeploymentExecutionRoleName":{ + "shape":"ConfigurationDefinitionLocalDeploymentExecutionRoleNameString", + "documentation":"The name of the IAM role used to deploy local configurations.
" + }, + "Parameters":{ + "shape":"ConfigurationParametersMap", + "documentation":"A list of key-value pairs containing the required parameters for the configuration type.
" + }, + "Type":{ + "shape":"ConfigurationDefinitionTypeString", + "documentation":"The type of the Quick Setup configuration.
" + }, + "TypeVersion":{ + "shape":"ConfigurationDefinitionTypeVersionString", + "documentation":"The version of the Quick Setup type used.
" + } + }, + "documentation":"The definition of a Quick Setup configuration.
" + }, + "ConfigurationDefinitionInput":{ + "type":"structure", + "required":[ + "Parameters", + "Type" + ], + "members":{ + "LocalDeploymentAdministrationRoleArn":{ + "shape":"IAMRoleArn", + "documentation":"The ARN of the IAM role used to administrate local configuration deployments.
" + }, + "LocalDeploymentExecutionRoleName":{ + "shape":"ConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString", + "documentation":"The name of the IAM role used to deploy local configurations.
" + }, + "Parameters":{ + "shape":"ConfigurationParametersMap", + "documentation":"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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
The type of the Quick Setup configuration.
" + }, + "TypeVersion":{ + "shape":"ConfigurationDefinitionInputTypeVersionString", + "documentation":"The version of the Quick Setup type to use.
" + } + }, + "documentation":"Defines the preferences and options for a configuration definition.
" + }, + "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", + "documentation":"The common parameters and values for the configuration definition.
" + }, + "Id":{ + "shape":"String", + "documentation":"The ID of the configuration definition.
" + }, + "Type":{ + "shape":"String", + "documentation":"The type of the Quick Setup configuration used by the configuration definition.
" + }, + "TypeVersion":{ + "shape":"String", + "documentation":"The version of the Quick Setup type used by the configuration definition.
" + } + }, + "documentation":"A summarized definition of a Quick Setup configuration definition.
" + }, + "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", + "documentation":"A summary of the Quick Setup configuration definition.
" + }, + "Description":{ + "shape":"String", + "documentation":"The description of the configuration.
" + }, + "ManagerArn":{ + "shape":"String", + "documentation":"The ARN of the Quick Setup configuration.
" + }, + "Name":{ + "shape":"String", + "documentation":"The name of the configuration
" + }, + "StatusSummaries":{ + "shape":"StatusSummariesList", + "documentation":"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.
" + } + }, + "documentation":"A summary of a Quick Setup configuration manager.
" + }, + "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"} + }, + "documentation":"Another request is being processed. Wait a few minutes and try again.
", + "error":{ + "httpStatusCode":409, + "senderFault":true + }, + "exception":true + }, + "CreateConfigurationManagerInput":{ + "type":"structure", + "required":["ConfigurationDefinitions"], + "members":{ + "ConfigurationDefinitions":{ + "shape":"ConfigurationDefinitionsInputList", + "documentation":"The definition of the Quick Setup configuration that the configuration manager deploys.
" + }, + "Description":{ + "shape":"CreateConfigurationManagerInputDescriptionString", + "documentation":"A description of the configuration manager.
" + }, + "Name":{ + "shape":"CreateConfigurationManagerInputNameString", + "documentation":"A name for the configuration manager.
" + }, + "Tags":{ + "shape":"TagsMap", + "documentation":"Key-value pairs of metadata to assign to the configuration manager.
" + } + } + }, + "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", + "documentation":"The ARN for the newly created configuration manager.
" + } + } + }, + "DeleteConfigurationManagerInput":{ + "type":"structure", + "required":["ManagerArn"], + "members":{ + "ManagerArn":{ + "shape":"DeleteConfigurationManagerInputManagerArnString", + "documentation":"The ID of the configuration manager.
", + "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", + "documentation":"The key for the filter.
" + }, + "Values":{ + "shape":"FilterValues", + "documentation":"The values for the filter keys.
" + } + }, + "documentation":"A key-value pair to filter results.
" + }, + "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", + "documentation":"The ARN of the configuration manager.
", + "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", + "documentation":"The configuration definitions association with the configuration manager.
" + }, + "CreatedAt":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"The datetime stamp when the configuration manager was created.
" + }, + "Description":{ + "shape":"String", + "documentation":"The description of the configuration manager.
" + }, + "LastModifiedAt":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"The datetime stamp when the configuration manager was last updated.
" + }, + "ManagerArn":{ + "shape":"String", + "documentation":"The ARN of the configuration manager.
" + }, + "Name":{ + "shape":"String", + "documentation":"The name of the configuration manager.
" + }, + "StatusSummaries":{ + "shape":"StatusSummariesList", + "documentation":"A summary of the state of the configuration manager. This includes deployment statuses, association statuses, drift statuses, health checks, and more.
" + }, + "Tags":{ + "shape":"TagsMap", + "documentation":"Key-value pairs of metadata to assign to the configuration manager.
" + } + } + }, + "GetServiceSettingsOutput":{ + "type":"structure", + "members":{ + "ServiceSettings":{ + "shape":"ServiceSettings", + "documentation":"Returns details about the settings for Quick Setup in the requesting Amazon Web Services account and Amazon Web Services Region.
" + } + } + }, + "IAMRoleArn":{"type":"string"}, + "InternalServerException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "documentation":"An error occurred on the server side.
", + "error":{"httpStatusCode":500}, + "exception":true, + "fault":true, + "retryable":{"throttling":false} + }, + "ListConfigurationManagersInput":{ + "type":"structure", + "members":{ + "Filters":{ + "shape":"FiltersList", + "documentation":"Filters the results returned by the request.
" + }, + "MaxItems":{ + "shape":"ListConfigurationManagersInputMaxItemsInteger", + "documentation":"Specifies the maximum number of configuration managers that are returned by the request.
" + }, + "StartingToken":{ + "shape":"ListConfigurationManagersInputStartingTokenString", + "documentation":"The token to use when requesting a specific set of items from a list.
" + } + } + }, + "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", + "documentation":"The configuration managers returned by the request.
" + }, + "NextToken":{ + "shape":"String", + "documentation":"The token to use when requesting the next set of configuration managers. If there are no additional operations to return, the string is empty.
" + } + } + }, + "ListQuickSetupTypesOutput":{ + "type":"structure", + "members":{ + "QuickSetupTypeList":{ + "shape":"QuickSetupTypeList", + "documentation":"An array of Quick Setup types.
" + } + } + }, + "ListTagsForResourceRequest":{ + "type":"structure", + "required":["ResourceArn"], + "members":{ + "ResourceArn":{ + "shape":"String", + "documentation":"The ARN of the resource the tag is assigned to.
", + "location":"uri", + "locationName":"ResourceArn" + } + } + }, + "ListTagsForResourceResponse":{ + "type":"structure", + "members":{ + "Tags":{ + "shape":"Tags", + "documentation":"Key-value pairs of metadata assigned to the resource.
" + } + } + }, + "QuickSetupTypeList":{ + "type":"list", + "member":{"shape":"QuickSetupTypeOutput"} + }, + "QuickSetupTypeOutput":{ + "type":"structure", + "members":{ + "LatestVersion":{ + "shape":"String", + "documentation":"The latest version number of the configuration.
" + }, + "Type":{ + "shape":"String", + "documentation":"The type of the Quick Setup configuration.
" + } + }, + "documentation":"Information about the Quick Setup type.
" + }, + "ResourceNotFoundException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "documentation":"The resource couldn't be found. Check the ID or name and try again.
", + "error":{ + "httpStatusCode":404, + "senderFault":true + }, + "exception":true + }, + "ServiceSettings":{ + "type":"structure", + "members":{ + "ExplorerEnablingRoleArn":{ + "shape":"IAMRoleArn", + "documentation":"The IAM role used to enable Explorer.
" + } + }, + "documentation":"Settings configured for Quick Setup.
" + }, + "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", + "documentation":"The datetime stamp when the status was last updated.
" + }, + "Status":{ + "shape":"Status", + "documentation":"The current status.
" + }, + "StatusDetails":{ + "shape":"StatusDetails", + "documentation":"Details about the status.
" + }, + "StatusMessage":{ + "shape":"String", + "documentation":"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.
" + }, + "StatusType":{ + "shape":"StatusType", + "documentation":"The type of a status summary.
" + } + }, + "documentation":"A summarized description of the status.
" + }, + "StatusType":{ + "type":"string", + "enum":[ + "Deployment", + "AsyncExecutions" + ] + }, + "String":{"type":"string"}, + "SyntheticTimestamp_date_time":{ + "type":"timestamp", + "timestampFormat":"iso8601" + }, + "TagEntry":{ + "type":"structure", + "members":{ + "Key":{ + "shape":"TagEntryKeyString", + "documentation":"The key for the tag.
" + }, + "Value":{ + "shape":"TagEntryValueString", + "documentation":"The value for the tag.
" + } + }, + "documentation":"Key-value pairs of metadata.
", + "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", + "documentation":"The ARN of the resource to tag.
", + "location":"uri", + "locationName":"ResourceArn" + }, + "Tags":{ + "shape":"TagsMap", + "documentation":"Key-value pairs of metadata to assign to the resource.
" + } + } + }, + "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"} + }, + "documentation":"The request or operation exceeds the maximum allowed request rate per Amazon Web Services account and Amazon Web Services Region.
", + "error":{ + "httpStatusCode":429, + "senderFault":true + }, + "exception":true, + "retryable":{"throttling":false} + }, + "UntagResourceInput":{ + "type":"structure", + "required":[ + "ResourceArn", + "TagKeys" + ], + "members":{ + "ResourceArn":{ + "shape":"String", + "documentation":"The ARN of the resource to remove tags from.
", + "location":"uri", + "locationName":"ResourceArn" + }, + "TagKeys":{ + "shape":"TagKeys", + "documentation":"The keys of the tags to remove from the resource.
", + "location":"querystring", + "locationName":"tagKeys" + } + } + }, + "UpdateConfigurationDefinitionInput":{ + "type":"structure", + "required":[ + "Id", + "ManagerArn" + ], + "members":{ + "Id":{ + "shape":"UpdateConfigurationDefinitionInputIdString", + "documentation":"The ID of the configuration definition you want to update.
", + "location":"uri", + "locationName":"Id" + }, + "LocalDeploymentAdministrationRoleArn":{ + "shape":"IAMRoleArn", + "documentation":"The ARN of the IAM role used to administrate local configuration deployments.
" + }, + "LocalDeploymentExecutionRoleName":{ + "shape":"UpdateConfigurationDefinitionInputLocalDeploymentExecutionRoleNameString", + "documentation":"The name of the IAM role used to deploy local configurations.
" + }, + "ManagerArn":{ + "shape":"UpdateConfigurationDefinitionInputManagerArnString", + "documentation":"The ARN of the configuration manager associated with the definition to update.
", + "location":"uri", + "locationName":"ManagerArn" + }, + "Parameters":{ + "shape":"ConfigurationParametersMap", + "documentation":"The parameters for the configuration definition type.
" + }, + "TypeVersion":{ + "shape":"UpdateConfigurationDefinitionInputTypeVersionString", + "documentation":"The version of the Quick Setup type to use.
" + } + } + }, + "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", + "documentation":"A description of the configuration manager.
" + }, + "ManagerArn":{ + "shape":"UpdateConfigurationManagerInputManagerArnString", + "documentation":"The ARN of the configuration manager.
", + "location":"uri", + "locationName":"ManagerArn" + }, + "Name":{ + "shape":"UpdateConfigurationManagerInputNameString", + "documentation":"A name for the configuration manager.
" + } + } + }, + "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", + "documentation":"The IAM role used to enable Explorer.
" + } + } + }, + "ValidationException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "documentation":"The request is invalid. Verify the values provided for the request parameters are accurate.
", + "error":{ + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + } + }, + "documentation":"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.
" +} diff --git a/botocore/data/support/2013-04-15/service-2.json b/botocore/data/support/2013-04-15/service-2.json index bde6d62f88..abfad31c8e 100644 --- a/botocore/data/support/2013-04-15/service-2.json +++ b/botocore/data/support/2013-04-15/service-2.json @@ -10,7 +10,8 @@ "serviceId":"Support", "signatureVersion":"v4", "targetPrefix":"AWSSupport_20130415", - "uid":"support-2013-04-15" + "uid":"support-2013-04-15", + "auth":["aws.auth#sigv4"] }, "operations":{ "AddAttachmentsToSet":{ @@ -317,7 +318,7 @@ "documentation":"The content of the attachment file.
" } }, - "documentation":"An attachment to a case communication. The attachment consists of the file name and the content of the file.
" + "documentation":"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
" }, "AttachmentDetails":{ "type":"structure", @@ -429,7 +430,7 @@ }, "status":{ "shape":"Status", - "documentation":"The status of the case.
Valid values:
opened
pending-customer-action
reopened
resolved
unassigned
work-in-progress
The status of the case.
Valid values:
all-open
customer-action-completed
opened
pending-customer-action
reopened
resolved
unassigned
work-in-progress
The language in which Amazon Web Services Support handles the case. Amazon Web Services Support currently supports Chinese (“zh”), English (\"en\"), Japanese (\"ja\") and Korean (“ko”). You must specify the ISO 639-1 code for the language
parameter if you want support in that language.
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:
caseId - The support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47.
categoryCode - The category of problem for the support case. Corresponds to the CategoryCode
values returned by a call to DescribeServices.
displayId - The identifier for the case on pages in the Amazon Web Services Support Center.
language - The language in which Amazon Web Services Support handles the case. Amazon Web Services Support currently supports Chinese (“zh”), English (\"en\"), Japanese (\"ja\") and Korean (“ko”). You must specify the ISO 639-1 code for the language
parameter if you want support in that language.
nextToken - A resumption point for pagination.
recentCommunications - One or more Communication objects. Fields of these objects are attachments
, body
, caseId
, submittedBy
, and timeCreated
.
serviceCode - The identifier for the Amazon Web Services service that corresponds to the service code defined in the call to DescribeServices.
severityCode - The severity code assigned to the case. Contains one of the values returned by the call to DescribeSeverityLevels. The possible values are: low
, normal
, high
, urgent
, and critical
.
status - The status of the case in the Amazon Web Services Support Center. Valid values:
opened
pending-customer-action
reopened
resolved
unassigned
work-in-progress
subject - The subject line of the case.
submittedBy - The email address of the account that submitted the case.
timeCreated - The time the case was created, in ISO-8601 format.
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:
caseId - The support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47.
categoryCode - The category of problem for the support case. Corresponds to the CategoryCode
values returned by a call to DescribeServices.
displayId - The identifier for the case on pages in the Amazon Web Services Support Center.
language - The language in which Amazon Web Services Support handles the case. Amazon Web Services Support currently supports Chinese (“zh”), English (\"en\"), Japanese (\"ja\") and Korean (“ko”). You must specify the ISO 639-1 code for the language
parameter if you want support in that language.
nextToken - A resumption point for pagination.
recentCommunications - One or more Communication objects. Fields of these objects are attachments
, body
, caseId
, submittedBy
, and timeCreated
.
serviceCode - The identifier for the Amazon Web Services service that corresponds to the service code defined in the call to DescribeServices.
severityCode - The severity code assigned to the case. Contains one of the values returned by the call to DescribeSeverityLevels. The possible values are: low
, normal
, high
, urgent
, and critical
.
status - The status of the case in the Amazon Web Services Support Center. Valid values:
all-open
customer-action-completed
opened
pending-customer-action
reopened
resolved
unassigned
work-in-progress
subject - The subject line of the case.
submittedBy - The email address of the account that submitted the case.
timeCreated - The time the case was created, in ISO-8601 format.
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 must have a Business, Enterprise On-Ramp, or Enterprise Support plan to use the Amazon Web Services Support API.
If you call the Amazon Web Services Support API from an account that doesn't have a Business, Enterprise On-Ramp, or Enterprise Support plan, the SubscriptionRequiredException
error message appears. For information about changing your support plan, see Amazon Web Services Support.
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:
The CreateCase, DescribeCases, DescribeAttachment, and ResolveCase operations create Amazon Web Services Support cases, retrieve information about cases, and resolve cases.
The DescribeCommunications, AddCommunicationToCase, and AddAttachmentsToSet operations retrieve and add communications and attachments to Amazon Web Services Support cases.
The DescribeServices and DescribeSeverityLevels operations return Amazon Web Service names, service codes, service categories, and problem severity levels. You use these values when you call the CreateCase operation.
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.
" + "documentation":"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 must have a Business, Enterprise On-Ramp, or Enterprise Support plan to use the Amazon Web Services Support API.
If you call the Amazon Web Services Support API from an account that doesn't have a Business, Enterprise On-Ramp, or Enterprise Support plan, the SubscriptionRequiredException
error message appears. For information about changing your support plan, see Amazon Web Services Support.
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:
The CreateCase, DescribeCases, DescribeAttachment, and ResolveCase operations create Amazon Web Services Support cases, retrieve information about cases, and resolve cases.
The DescribeCommunications, AddCommunicationToCase, and AddAttachmentsToSet operations retrieve and add communications and attachments to Amazon Web Services Support cases.
The DescribeServices and DescribeSeverityLevels operations return Amazon Web Service names, service codes, service categories, and problem severity levels. You use these values when you call the CreateCase operation.
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.
" } diff --git a/docs/source/conf.py b/docs/source/conf.py index ae6f0f6ef7..3690369066 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -59,7 +59,7 @@ # The short X.Y version. version = '1.34.1' # The full version, including alpha/beta/rc tags. -release = '1.34.151' +release = '1.34.152' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/tests/functional/endpoint-rules/ssm-quicksetup/endpoint-tests-1.json b/tests/functional/endpoint-rules/ssm-quicksetup/endpoint-tests-1.json new file mode 100644 index 0000000000..7397c01138 --- /dev/null +++ b/tests/functional/endpoint-rules/ssm-quicksetup/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