{"files":{"SKILL.md":"---\nname: amazonmwaa\ndescription: \"AmazonMWAA API skill. Use when working with AmazonMWAA for clitoken, environments, webtoken. Covers 11 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# AmazonMWAA\nAPI version: 2020-07-01\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. GET /environments -- lists the amazon managed workflows for apache airflow (mwaa) environments.\n3. POST /clitoken/{Name} -- create first clitoken\n\n## Endpoints\n11 endpoints across 5 groups. See references/api-spec.lap for full details.\n\n### Clitoken\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /clitoken/{Name} | Creates a CLI token for the Airflow CLI. To learn more, see Creating an Apache Airflow CLI token. |\n\n### Environments\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /environments/{Name} | Creates an Amazon Managed Workflows for Apache Airflow (MWAA) environment. |\n| DELETE | /environments/{Name} | Deletes an Amazon Managed Workflows for Apache Airflow (MWAA) environment. |\n| GET | /environments/{Name} | Describes an Amazon Managed Workflows for Apache Airflow (MWAA) environment. |\n| GET | /environments | Lists the Amazon Managed Workflows for Apache Airflow (MWAA) environments. |\n| PATCH | /environments/{Name} | Updates an Amazon Managed Workflows for Apache Airflow (MWAA) environment. |\n\n### Webtoken\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /webtoken/{Name} | Creates a web login token for the Airflow Web UI. To learn more, see Creating an Apache Airflow web login token. |\n\n### Tags\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /tags/{ResourceArn} | Lists the key-value tag pairs associated to the Amazon Managed Workflows for Apache Airflow (MWAA) environment. For example, \"Environment\": \"Staging\". |\n| POST | /tags/{ResourceArn} | Associates key-value tag pairs to your Amazon Managed Workflows for Apache Airflow (MWAA) environment. |\n| DELETE | /tags/{ResourceArn} | Removes key-value tag pairs associated to your Amazon Managed Workflows for Apache Airflow (MWAA) environment. For example, \"Environment\": \"Staging\". |\n\n### Metrics\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /metrics/environments/{EnvironmentName} | Internal only. Publishes environment health metrics to Amazon CloudWatch. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Update a environment?\" -> PUT /environments/{Name}\n- \"Delete a environment?\" -> DELETE /environments/{Name}\n- \"Get environment details?\" -> GET /environments/{Name}\n- \"List all environments?\" -> GET /environments\n- \"Get tag details?\" -> GET /tags/{ResourceArn}\n- \"Delete a tag?\" -> DELETE /tags/{ResourceArn}\n- \"Partially update a environment?\" -> PATCH /environments/{Name}\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api AmazonMWAA\n@version 2020-07-01\n@auth AWS SigV4\n@endpoints 11\n@toc clitoken(1), environments(5), webtoken(1), tags(3), metrics(1)\n\n@group clitoken\n@endpoint POST /clitoken/{Name}\n@desc Creates a CLI token for the Airflow CLI. To learn more, see Creating an Apache Airflow CLI token.\n@required {Name: str}\n@returns(200) {CliToken: str?, WebServerHostname: str?}\n\n@endgroup\n\n@group environments\n@endpoint PUT /environments/{Name}\n@desc Creates an Amazon Managed Workflows for Apache Airflow (MWAA) environment.\n@required {Name: str, ExecutionRoleArn: str, SourceBucketArn: str, DagS3Path: str, NetworkConfiguration: NetworkConfiguration}\n@optional {PluginsS3Path: str, PluginsS3ObjectVersion: str, RequirementsS3Path: str, RequirementsS3ObjectVersion: str, StartupScriptS3Path: str, StartupScriptS3ObjectVersion: str, AirflowConfigurationOptions: map<str,str>, EnvironmentClass: str, MaxWorkers: int, KmsKey: str, AirflowVersion: str, LoggingConfiguration: LoggingConfigurationInput, WeeklyMaintenanceWindowStart: str, Tags: map<str,str>, WebserverAccessMode: str, MinWorkers: int, Schedulers: int, EndpointManagement: str, MinWebservers: int, MaxWebservers: int}\n@returns(200) {Arn: str?}\n\n@endgroup\n\n@group webtoken\n@endpoint POST /webtoken/{Name}\n@desc Creates a web login token for the Airflow Web UI. To learn more, see Creating an Apache Airflow web login token.\n@required {Name: str}\n@returns(200) {WebToken: str?, WebServerHostname: str?, IamIdentity: str?, AirflowIdentity: str?}\n\n@endgroup\n\n@group environments\n@endpoint DELETE /environments/{Name}\n@desc Deletes an Amazon Managed Workflows for Apache Airflow (MWAA) environment.\n@required {Name: str}\n\n@endpoint GET /environments/{Name}\n@desc Describes an Amazon Managed Workflows for Apache Airflow (MWAA) environment.\n@required {Name: str}\n@returns(200) {Environment: Environment?{Name: str?, Status: str?, Arn: str?, CreatedAt: str(timestamp)?, WebserverUrl: str?, ExecutionRoleArn: str?, ServiceRoleArn: str?, KmsKey: str?, AirflowVersion: str?, SourceBucketArn: str?, DagS3Path: str?, PluginsS3Path: str?, PluginsS3ObjectVersion: str?, RequirementsS3Path: str?, RequirementsS3ObjectVersion: str?, StartupScriptS3Path: str?, StartupScriptS3ObjectVersion: str?, AirflowConfigurationOptions: map<str, str>?: any, EnvironmentClass: str?, MaxWorkers: int?, NetworkConfiguration: NetworkConfiguration?{SubnetIds: [str]?, SecurityGroupIds: [str]?}, LoggingConfiguration: LoggingConfiguration?{DagProcessingLogs: ModuleLoggingConfiguration?{Enabled: bool?, LogLevel: str?, CloudWatchLogGroupArn: str?}, SchedulerLogs: ModuleLoggingConfiguration?{Enabled: bool?, LogLevel: str?, CloudWatchLogGroupArn: str?}, WebserverLogs: ModuleLoggingConfiguration?{Enabled: bool?, LogLevel: str?, CloudWatchLogGroupArn: str?}, WorkerLogs: ModuleLoggingConfiguration?{Enabled: bool?, LogLevel: str?, CloudWatchLogGroupArn: str?}, TaskLogs: ModuleLoggingConfiguration?{Enabled: bool?, LogLevel: str?, CloudWatchLogGroupArn: str?}}, LastUpdate: LastUpdate?{Status: str?, CreatedAt: str(timestamp)?, Error: UpdateError?{ErrorCode: str?, ErrorMessage: str?}, Source: str?}, WeeklyMaintenanceWindowStart: str?, Tags: map<str, str>?: any, WebserverAccessMode: str?, MinWorkers: int?, Schedulers: int?, WebserverVpcEndpointService: str?, DatabaseVpcEndpointService: str?, CeleryExecutorQueue: str?, EndpointManagement: str?, MinWebservers: int?, MaxWebservers: int?}}\n\n@endpoint GET /environments\n@desc Lists the Amazon Managed Workflows for Apache Airflow (MWAA) environments.\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {Environments: [str], NextToken: str?}\n\n@endgroup\n\n@group tags\n@endpoint GET /tags/{ResourceArn}\n@desc Lists the key-value tag pairs associated to the Amazon Managed Workflows for Apache Airflow (MWAA) environment. For example, \"Environment\": \"Staging\".\n@required {ResourceArn: str}\n@returns(200) {Tags: map<str,str>?}\n\n@endgroup\n\n@group metrics\n@endpoint POST /metrics/environments/{EnvironmentName}\n@desc Internal only. Publishes environment health metrics to Amazon CloudWatch.\n@required {EnvironmentName: str, MetricData: [MetricDatum]}\n\n@endgroup\n\n@group tags\n@endpoint POST /tags/{ResourceArn}\n@desc Associates key-value tag pairs to your Amazon Managed Workflows for Apache Airflow (MWAA) environment.\n@required {ResourceArn: str, Tags: map<str,str>}\n\n@endpoint DELETE /tags/{ResourceArn}\n@desc Removes key-value tag pairs associated to your Amazon Managed Workflows for Apache Airflow (MWAA) environment. For example, \"Environment\": \"Staging\".\n@required {ResourceArn: str, tagKeys: [str]}\n\n@endgroup\n\n@group environments\n@endpoint PATCH /environments/{Name}\n@desc Updates an Amazon Managed Workflows for Apache Airflow (MWAA) environment.\n@required {Name: str}\n@optional {ExecutionRoleArn: str, AirflowVersion: str, SourceBucketArn: str, DagS3Path: str, PluginsS3Path: str, PluginsS3ObjectVersion: str, RequirementsS3Path: str, RequirementsS3ObjectVersion: str, StartupScriptS3Path: str, StartupScriptS3ObjectVersion: str, AirflowConfigurationOptions: map<str,str>, EnvironmentClass: str, MaxWorkers: int, NetworkConfiguration: UpdateNetworkConfigurationInput, LoggingConfiguration: LoggingConfigurationInput, WeeklyMaintenanceWindowStart: str, WebserverAccessMode: str, MinWorkers: int, Schedulers: int, MinWebservers: int, MaxWebservers: int}\n@returns(200) {Arn: str?}\n\n@endgroup\n\n@end\n"}}