Integrate AWS AppConfig into workflows. Manage applications, environments, and configuration profiles, create and read hosted configuration versions, run and inspect deployments, and retrieve the latest deployed configuration at runtime. Requires AWS access key and secret access key.
Retrieve the latest deployed configuration for an AppConfig application, environment, and profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID or name to retrieve configuration for |
environmentId | string | はい | The environment ID or name to retrieve configuration for |
configurationProfileId | string | はい | The configuration profile ID or name to retrieve |
| パラメータ | 型 | 説明 |
|---|
configuration | string | The deployed configuration content |
contentType | string | Content type of the configuration |
versionLabel | string | Label of the retrieved configuration version |
List applications in AWS AppConfig
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
maxResults | number | いいえ | Maximum number of applications to return (1-50) |
nextToken | string | いいえ | Pagination token from a previous response |
| パラメータ | 型 | 説明 |
|---|
applications | array | List of AppConfig applications |
↳ id | string | Application ID |
↳ name | string | Application name |
↳ description | string | Application description |
nextToken | string | Pagination token for the next page |
count | number | Number of applications returned |
Create an application in AWS AppConfig
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
name | string | はい | Name of the application to create |
description | string | いいえ | Description of the application |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
id | string | ID of the created application |
name | string | Name of the created application |
description | string | Description of the created application |
Get details about a single AWS AppConfig application
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID to retrieve |
| パラメータ | 型 | 説明 |
|---|
id | string | Application ID |
name | string | Application name |
description | string | Application description |
Update the name or description of an AWS AppConfig application
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID to update |
name | string | いいえ | New name for the application |
description | string | いいえ | New description for the application |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
id | string | ID of the updated application |
name | string | Name of the updated application |
description | string | Description of the updated application |
Delete an AWS AppConfig application
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID to delete |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
id | string | ID of the deleted application |
List environments for an AWS AppConfig application
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the environments |
maxResults | number | いいえ | Maximum number of environments to return (1-50) |
nextToken | string | いいえ | Pagination token from a previous response |
| パラメータ | 型 | 説明 |
|---|
environments | array | List of AppConfig environments |
↳ applicationId | string | Owning application ID |
↳ id | string | Environment ID |
↳ name | string | Environment name |
↳ description | string | Environment description |
↳ state | string | Environment state |
nextToken | string | Pagination token for the next page |
count | number | Number of environments returned |
Create an environment for an AWS AppConfig application
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID to create the environment in |
name | string | はい | Name of the environment to create |
description | string | いいえ | Description of the environment |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
id | string | ID of the created environment |
name | string | Name of the created environment |
state | string | State of the created environment |
Get details about a single AWS AppConfig environment
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the environment |
environmentId | string | はい | The environment ID to retrieve |
| パラメータ | 型 | 説明 |
|---|
applicationId | string | Owning application ID |
id | string | Environment ID |
name | string | Environment name |
description | string | Environment description |
state | string | Environment state |
monitors | array | CloudWatch alarms monitoring this environment |
↳ alarmArn | string | CloudWatch alarm ARN |
↳ alarmRoleArn | string | IAM role ARN for the alarm |
Update the name or description of an AWS AppConfig environment
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the environment |
environmentId | string | はい | The environment ID to update |
name | string | いいえ | New name for the environment |
description | string | いいえ | New description for the environment |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
id | string | ID of the updated environment |
name | string | Name of the updated environment |
state | string | State of the updated environment |
Delete an AWS AppConfig environment
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the environment |
environmentId | string | はい | The environment ID to delete |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
id | string | ID of the deleted environment |
List configuration profiles for an AWS AppConfig application
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profiles |
maxResults | number | いいえ | Maximum number of configuration profiles to return (1-50) |
nextToken | string | いいえ | Pagination token from a previous response |
| パラメータ | 型 | 説明 |
|---|
configurationProfiles | array | List of AppConfig configuration profiles |
↳ applicationId | string | Owning application ID |
↳ id | string | Configuration profile ID |
↳ name | string | Configuration profile name |
↳ locationUri | string | Location URI of the config |
↳ type | string | Profile type (e.g., AWS.Freeform) |
↳ validatorTypes | array | Validator types configured |
nextToken | string | Pagination token for the next page |
count | number | Number of configuration profiles returned |
Create a configuration profile in an AWS AppConfig application
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID to create the configuration profile in |
name | string | はい | Name of the configuration profile |
locationUri | string | はい | Where the configuration is stored. Use "hosted" for AppConfig-hosted configurations, or an SSM/S3 URI |
description | string | いいえ | Description of the configuration profile |
retrievalRoleArn | string | いいえ | ARN of an IAM role to retrieve the configuration (required for non-hosted URIs) |
type | string | いいえ | Profile type: AWS.Freeform (default) or AWS.AppConfig.FeatureFlags |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
id | string | ID of the created configuration profile |
name | string | Name of the created configuration profile |
locationUri | string | Location URI of the config |
type | string | Profile type |
Get details about a single AWS AppConfig configuration profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profile |
configurationProfileId | string | はい | The configuration profile ID to retrieve |
| パラメータ | 型 | 説明 |
|---|
applicationId | string | Owning application ID |
id | string | Configuration profile ID |
name | string | Configuration profile name |
description | string | Profile description |
locationUri | string | Location URI of the config |
retrievalRoleArn | string | IAM retrieval role ARN |
type | string | Profile type (e.g., AWS.Freeform) |
validators | array | Validators configured on the profile |
↳ type | string | Validator type (JSON_SCHEMA or LAMBDA) |
Update the name, description, or retrieval role of an AppConfig configuration profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profile |
configurationProfileId | string | はい | The configuration profile ID to update |
name | string | いいえ | New name for the configuration profile |
description | string | いいえ | New description for the configuration profile |
retrievalRoleArn | string | いいえ | New ARN of the IAM role used to retrieve the configuration |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
id | string | ID of the updated configuration profile |
name | string | Name of the updated configuration profile |
description | string | Description of the profile |
type | string | Profile type |
Delete an AWS AppConfig configuration profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profile |
configurationProfileId | string | はい | The configuration profile ID to delete |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
id | string | ID of the deleted configuration profile |
Create a new hosted configuration version for an AppConfig configuration profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profile |
configurationProfileId | string | はい | The configuration profile ID to add the version to |
content | string | はい | The configuration content (e.g., a JSON or YAML document) |
contentType | string | はい | Content type of the configuration (e.g., application/json, text/plain) |
description | string | いいえ | Description of the configuration version |
latestVersionNumber | number | いいえ | The version number of the latest version, used for optimistic concurrency |
versionLabel | string | いいえ | A user-defined label for the configuration version |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
configurationProfileId | string | Owning configuration profile ID |
versionNumber | number | Version number of the created configuration |
contentType | string | Content type of the configuration |
versionLabel | string | Label of the configuration version |
Retrieve a specific hosted configuration version from an AppConfig profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profile |
configurationProfileId | string | はい | The configuration profile ID to read the version from |
versionNumber | number | はい | The version number to retrieve |
| パラメータ | 型 | 説明 |
|---|
applicationId | string | Owning application ID |
configurationProfileId | string | Owning configuration profile ID |
versionNumber | number | Version number |
description | string | Description of the version |
content | string | The configuration content |
contentType | string | Content type of the configuration |
versionLabel | string | Label of the configuration version |
List hosted configuration versions for an AWS AppConfig configuration profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profile |
configurationProfileId | string | はい | The configuration profile ID to list versions for |
maxResults | number | いいえ | Maximum number of versions to return (1-50) |
nextToken | string | いいえ | Pagination token from a previous response |
| パラメータ | 型 | 説明 |
|---|
versions | array | List of hosted configuration versions |
↳ applicationId | string | Owning application ID |
↳ configurationProfileId | string | Owning configuration profile ID |
↳ versionNumber | number | Version number |
↳ description | string | Description of the version |
↳ contentType | string | Content type of the configuration |
↳ versionLabel | string | Label of the configuration version |
nextToken | string | Pagination token for the next page |
count | number | Number of versions returned |
Delete a specific hosted configuration version from an AppConfig profile
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID that owns the configuration profile |
configurationProfileId | string | はい | The configuration profile ID that owns the version |
versionNumber | number | はい | The version number to delete |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
applicationId | string | Owning application ID |
configurationProfileId | string | Owning configuration profile ID |
versionNumber | number | Version number that was deleted |
List deployment strategies available in AWS AppConfig
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
maxResults | number | いいえ | Maximum number of deployment strategies to return (1-50) |
nextToken | string | いいえ | Pagination token from a previous response |
| パラメータ | 型 | 説明 |
|---|
deploymentStrategies | array | List of AppConfig deployment strategies |
↳ id | string | Deployment strategy ID |
↳ name | string | Deployment strategy name |
↳ description | string | Strategy description |
↳ deploymentDurationInMinutes | number | Total deployment duration in minutes |
↳ growthType | string | Growth type (LINEAR or EXPONENTIAL) |
↳ growthFactor | number | Growth factor percentage |
↳ finalBakeTimeInMinutes | number | Final bake time in minutes |
↳ replicateTo | string | Where the strategy is replicated |
nextToken | string | Pagination token for the next page |
count | number | Number of deployment strategies returned |
Start deploying a configuration version to an AWS AppConfig environment
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID to deploy in |
environmentId | string | はい | The environment ID to deploy to |
deploymentStrategyId | string | はい | The deployment strategy ID to use |
configurationProfileId | string | はい | The configuration profile ID to deploy |
configurationVersion | string | はい | The configuration version to deploy |
description | string | いいえ | Description of the deployment |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
deploymentNumber | number | Sequence number of the deployment |
state | string | Current deployment state |
percentageComplete | number | Percentage of the deployment that has completed |
Get details about a specific AWS AppConfig deployment
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID of the deployment |
environmentId | string | はい | The environment ID of the deployment |
deploymentNumber | number | はい | The sequence number of the deployment |
| パラメータ | 型 | 説明 |
|---|
applicationId | string | Application ID |
environmentId | string | Environment ID |
deploymentStrategyId | string | Deployment strategy ID |
configurationProfileId | string | Configuration profile ID |
deploymentNumber | number | Deployment sequence number |
configurationName | string | Configuration name |
configurationVersion | string | Configuration version |
description | string | Deployment description |
state | string | Current deployment state |
percentageComplete | number | Percentage completed |
startedAt | string | When the deployment started |
completedAt | string | When the deployment completed |
List deployments for an AWS AppConfig environment
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID of the deployments |
environmentId | string | はい | The environment ID of the deployments |
maxResults | number | いいえ | Maximum number of deployments to return (1-50) |
nextToken | string | いいえ | Pagination token from a previous response |
| パラメータ | 型 | 説明 |
|---|
deployments | array | List of AppConfig deployments |
↳ deploymentNumber | number | Deployment sequence number |
↳ configurationName | string | Configuration name |
↳ configurationVersion | string | Configuration version |
↳ state | string | Current deployment state |
↳ percentageComplete | number | Percentage completed |
↳ startedAt | string | When the deployment started |
↳ completedAt | string | When the deployment completed |
↳ versionLabel | string | Configuration version label |
nextToken | string | Pagination token for the next page |
count | number | Number of deployments returned |
Stop an in-progress AWS AppConfig deployment
| パラメータ | 型 | 必須 | 説明 |
|---|
region | string | はい | AWS region (e.g., us-east-1) |
accessKeyId | string | はい | AWS access key ID |
secretAccessKey | string | はい | AWS secret access key |
applicationId | string | はい | The application ID of the deployment |
environmentId | string | はい | The environment ID of the deployment |
deploymentNumber | number | はい | The sequence number of the deployment to stop |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
deploymentNumber | number | Deployment sequence number |
state | string | Deployment state after stopping |