openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

github.com/httptoolkit/openapi-directory-js

1 lines • 196 kB

JSON

{"openapi":"3.0.0","info":{"version":"2017-07-25","x-release":"v4","title":"AWS Glue DataBrew","description":"Glue DataBrew is a visual, cloud-scale data-preparation service. DataBrew simplifies data preparation tasks, targeting data issues that are hard to spot and time-consuming to fix. DataBrew empowers users of all technical levels to visualize the data and perform one-click data transformations, with no coding required.","x-logo":{"url":"https://twitter.com/awscloud/profile_image?size=original","backgroundColor":"#FFFFFF"},"termsOfService":"https://aws.amazon.com/service-terms/","contact":{"name":"Mike Ralphson","email":"mike.ralphson@gmail.com","url":"https://github.com/mermade/aws2openapi","x-twitter":"PermittedSoc"},"license":{"name":"Apache 2.0 License","url":"http://www.apache.org/licenses/"},"x-providerName":"amazonaws.com","x-serviceName":"databrew","x-aws-signingName":"databrew","x-origin":[{"contentType":"application/json","url":"https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/databrew-2017-07-25.normal.json","converter":{"url":"https://github.com/mermade/aws2openapi","version":"1.0.0"},"x-apisguru-driver":"external"}],"x-apiClientRegistration":{"url":"https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct"},"x-apisguru-categories":["cloud"],"x-preferred":true},"externalDocs":{"description":"Amazon Web Services documentation","url":"https://docs.aws.amazon.com/databrew/"},"servers":[{"url":"http://databrew.{region}.amazonaws.com","variables":{"region":{"description":"The AWS region","enum":["us-east-1","us-east-2","us-west-1","us-west-2","us-gov-west-1","us-gov-east-1","ca-central-1","eu-north-1","eu-west-1","eu-west-2","eu-west-3","eu-central-1","eu-south-1","af-south-1","ap-northeast-1","ap-northeast-2","ap-northeast-3","ap-southeast-1","ap-southeast-2","ap-east-1","ap-south-1","sa-east-1","me-south-1"],"default":"us-east-1"}},"description":"The AWS Glue DataBrew multi-region endpoint"},{"url":"https://databrew.{region}.amazonaws.com","variables":{"region":{"description":"The AWS region","enum":["us-east-1","us-east-2","us-west-1","us-west-2","us-gov-west-1","us-gov-east-1","ca-central-1","eu-north-1","eu-west-1","eu-west-2","eu-west-3","eu-central-1","eu-south-1","af-south-1","ap-northeast-1","ap-northeast-2","ap-northeast-3","ap-southeast-1","ap-southeast-2","ap-east-1","ap-south-1","sa-east-1","me-south-1"],"default":"us-east-1"}},"description":"The AWS Glue DataBrew multi-region endpoint"},{"url":"http://databrew.{region}.amazonaws.com.cn","variables":{"region":{"description":"The AWS region","enum":["cn-north-1","cn-northwest-1"],"default":"cn-north-1"}},"description":"The AWS Glue DataBrew endpoint for China (Beijing) and China (Ningxia)"},{"url":"https://databrew.{region}.amazonaws.com.cn","variables":{"region":{"description":"The AWS region","enum":["cn-north-1","cn-northwest-1"],"default":"cn-north-1"}},"description":"The AWS Glue DataBrew endpoint for China (Beijing) and China (Ningxia)"}],"x-hasEquivalentPaths":true,"paths":{"/recipes/{name}/batchDeleteRecipeVersion":{"post":{"operationId":"BatchDeleteRecipeVersion","description":"Deletes one or more versions of a recipe at a time. The entire request will be rejected if: <ul> <li> The recipe does not exist. </li> <li> There is an invalid version identifier in the list of versions. </li> <li> The version list is empty. </li> <li> The version list size exceeds 50. </li> <li> The version list contains duplicate entries. </li> </ul> The request will complete successfully, but with partial failures, if: <ul> <li> A version does not exist. </li> <li> A version is being used by a job. </li> <li> You specify <code>LATEST_WORKING</code>, but it's being used by a project. </li> <li> The version fails to be deleted. </li> </ul> The <code>LATEST_WORKING</code> version will only be deleted if the recipe has no other versions. If you try to delete <code>LATEST_WORKING</code> while other versions exist (or if they can't be deleted), then <code>LATEST_WORKING</code> will be listed as partial failure in the response.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDeleteRecipeVersionResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the recipe whose versions are to be deleted.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["RecipeVersions"],"properties":{"RecipeVersions":{"description":"An array of version identifiers, for the recipe versions to be deleted. You can specify numeric versions (<code>X.Y</code>) or <code>LATEST_WORKING</code>. <code>LATEST_PUBLISHED</code> is not supported.","type":"array","items":{"$ref":"#/components/schemas/RecipeVersion"},"minItems":1,"maxItems":50}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}]},"/datasets":{"post":{"operationId":"CreateDataset","description":"Creates a new DataBrew dataset.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDatasetResponse"}}}},"480":{"description":"AccessDeniedException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedException"}}}},"481":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"482":{"description":"ServiceQuotaExceededException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceQuotaExceededException"}}}},"483":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["Name","Input"],"properties":{"Name":{"description":"The name of the dataset to be created. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.","type":"string","minLength":1,"maxLength":255},"Format":{"description":"The file format of a dataset that is created from an Amazon S3 file or folder.","type":"string","enum":["CSV","JSON","PARQUET","EXCEL","ORC"]},"FormatOptions":{"description":"Represents a set of options that define the structure of either comma-separated value (CSV), Excel, or JSON input.","type":"object","properties":{"Json":{"allOf":[{"$ref":"#/components/schemas/JsonOptions"},{"description":"Options that define how JSON input is to be interpreted by DataBrew."}]},"Excel":{"allOf":[{"$ref":"#/components/schemas/ExcelOptions"},{"description":"Options that define how Excel input is to be interpreted by DataBrew."}]},"Csv":{"allOf":[{"$ref":"#/components/schemas/CsvOptions"},{"description":"Options that define how CSV input is to be interpreted by DataBrew."}]}}},"Input":{"description":"Represents information on how DataBrew can find data, in either the Glue Data Catalog or Amazon S3.","type":"object","properties":{"S3InputDefinition":{"allOf":[{"$ref":"#/components/schemas/S3Location"},{"description":"The Amazon S3 location where the data is stored."}]},"DataCatalogInputDefinition":{"allOf":[{"$ref":"#/components/schemas/DataCatalogInputDefinition"},{"description":"The Glue Data Catalog parameters for the data."}]},"DatabaseInputDefinition":{"allOf":[{"$ref":"#/components/schemas/DatabaseInputDefinition"},{"description":"Connection information for dataset input files stored in a database."}]},"Metadata":{"allOf":[{"$ref":"#/components/schemas/Metadata"},{"description":"Contains additional resource information needed for specific datasets."}]}}},"PathOptions":{"description":"Represents a set of options that define how DataBrew selects files for a given Amazon S3 path in a dataset.","type":"object","properties":{"LastModifiedDateCondition":{"allOf":[{"$ref":"#/components/schemas/FilterExpression"},{"description":"If provided, this structure defines a date range for matching Amazon S3 objects based on their LastModifiedDate attribute in Amazon S3."}]},"FilesLimit":{"allOf":[{"$ref":"#/components/schemas/FilesLimit"},{"description":"If provided, this structure imposes a limit on a number of files that should be selected."}]},"Parameters":{"allOf":[{"$ref":"#/components/schemas/PathParametersMap"},{"description":"A structure that maps names of parameters used in the Amazon S3 path of a dataset to their definitions."}]}}},"Tags":{"description":"Metadata tags to apply to this dataset.","type":"object","minProperties":1,"maxProperties":200,"additionalProperties":{"$ref":"#/components/schemas/TagValue"}}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"ListDatasets","description":"Lists all of the DataBrew datasets.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDatasetsResponse"}}}},"480":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"maxResults","in":"query","required":false,"description":"The maximum number of results to return in this request. ","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"nextToken","in":"query","required":false,"description":"The token returned by a previous call to retrieve the next set of results.","schema":{"type":"string","minLength":1,"maxLength":2000}},{"name":"MaxResults","in":"query","schema":{"type":"string"},"description":"Pagination limit","required":false},{"name":"NextToken","in":"query","schema":{"type":"string"},"description":"Pagination token","required":false}]}},"/profileJobs":{"post":{"operationId":"CreateProfileJob","description":"Creates a new job to analyze a dataset and create its data profile.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProfileJobResponse"}}}},"480":{"description":"AccessDeniedException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedException"}}}},"481":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"482":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"483":{"description":"ServiceQuotaExceededException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceQuotaExceededException"}}}},"484":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["DatasetName","Name","OutputLocation","RoleArn"],"properties":{"DatasetName":{"description":"The name of the dataset that this job is to act upon.","type":"string","minLength":1,"maxLength":255},"EncryptionKeyArn":{"description":"The Amazon Resource Name (ARN) of an encryption key that is used to protect the job.","type":"string","minLength":20,"maxLength":2048},"EncryptionMode":{"description":"The encryption mode for the job, which can be one of the following: <ul> <li> <code>SSE-KMS</code> - <code>SSE-KMS</code> - Server-side encryption with KMS-managed keys. </li> <li> <code>SSE-S3</code> - Server-side encryption with keys managed by Amazon S3. </li> </ul>","type":"string","enum":["SSE-KMS","SSE-S3"]},"Name":{"description":"The name of the job to be created. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.","type":"string","minLength":1,"maxLength":240},"LogSubscription":{"description":"Enables or disables Amazon CloudWatch logging for the job. If logging is enabled, CloudWatch writes one log stream for each job run.","type":"string","enum":["ENABLE","DISABLE"]},"MaxCapacity":{"description":"The maximum number of nodes that DataBrew can use when the job processes data.","type":"integer"},"MaxRetries":{"description":"The maximum number of times to retry the job after a job run fails.","type":"integer","minimum":0},"OutputLocation":{"description":"Represents an Amazon S3 location (bucket name, bucket owner, and object key) where DataBrew can read input data, or write output from a job.","type":"object","properties":{"Bucket":{"allOf":[{"$ref":"#/components/schemas/Bucket"},{"description":"The Amazon S3 bucket name."}]},"Key":{"allOf":[{"$ref":"#/components/schemas/Key"},{"description":"The unique name of the object in the bucket."}]},"BucketOwner":{"allOf":[{"$ref":"#/components/schemas/BucketOwner"},{"description":"The Amazon Web Services account ID of the bucket owner."}]}}},"Configuration":{"description":"Configuration for profile jobs. Configuration can be used to select columns, do evaluations, and override default parameters of evaluations. When configuration is undefined, the profile job will apply default settings to all supported columns. ","type":"object","properties":{"DatasetStatisticsConfiguration":{"allOf":[{"$ref":"#/components/schemas/StatisticsConfiguration"},{"description":"Configuration for inter-column evaluations. Configuration can be used to select evaluations and override parameters of evaluations. When configuration is undefined, the profile job will run all supported inter-column evaluations. "}]},"ProfileColumns":{"allOf":[{"$ref":"#/components/schemas/ColumnSelectorList"},{"description":"List of column selectors. ProfileColumns can be used to select columns from the dataset. When ProfileColumns is undefined, the profile job will profile all supported columns. "}]},"ColumnStatisticsConfigurations":{"allOf":[{"$ref":"#/components/schemas/ColumnStatisticsConfigurationList"},{"description":"List of configurations for column evaluations. ColumnStatisticsConfigurations are used to select evaluations and override parameters of evaluations for particular columns. When ColumnStatisticsConfigurations is undefined, the profile job will profile all supported columns and run all supported evaluations. "}]},"EntityDetectorConfiguration":{"allOf":[{"$ref":"#/components/schemas/EntityDetectorConfiguration"},{"description":"Configuration of entity detection for a profile job. When undefined, entity detection is disabled."}]}}},"ValidationConfigurations":{"description":"List of validation configurations that are applied to the profile job.","type":"array","items":{"$ref":"#/components/schemas/ValidationConfiguration"},"minItems":1},"RoleArn":{"description":"The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role to be assumed when DataBrew runs the job.","type":"string","minLength":20,"maxLength":2048},"Tags":{"description":"Metadata tags to apply to this job.","type":"object","minProperties":1,"maxProperties":200,"additionalProperties":{"$ref":"#/components/schemas/TagValue"}},"Timeout":{"description":"The job's timeout in minutes. A job that attempts to run longer than this timeout period ends with a status of <code>TIMEOUT</code>.","type":"integer","minimum":0},"JobSample":{"description":"A sample configuration for profile jobs only, which determines the number of rows on which the profile job is run. If a <code>JobSample</code> value isn't provided, the default is used. The default value is CUSTOM_ROWS for the mode parameter and 20,000 for the size parameter.","type":"object","properties":{"Mode":{"allOf":[{"$ref":"#/components/schemas/SampleMode"},{"description":"A value that determines whether the profile job is run on the entire dataset or a specified number of rows. This value must be one of the following: <ul> <li> FULL_DATASET - The profile job is run on the entire dataset. </li> <li> CUSTOM_ROWS - The profile job is run on the number of rows specified in the <code>Size</code> parameter. </li> </ul>"}]},"Size":{"allOf":[{"$ref":"#/components/schemas/JobSize"},{"description":"The <code>Size</code> parameter is only required when the mode is CUSTOM_ROWS. The profile job is run on the specified number of rows. The maximum value for size is Long.MAX_VALUE. Long.MAX_VALUE = 9223372036854775807"}]}}}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}]},"/projects":{"post":{"operationId":"CreateProject","description":"Creates a new DataBrew project.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProjectResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"InternalServerException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerException"}}}},"482":{"description":"ServiceQuotaExceededException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceQuotaExceededException"}}}},"483":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["DatasetName","Name","RecipeName","RoleArn"],"properties":{"DatasetName":{"description":"The name of an existing dataset to associate this project with.","type":"string","minLength":1,"maxLength":255},"Name":{"description":"A unique name for the new project. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.","type":"string","minLength":1,"maxLength":255},"RecipeName":{"description":"The name of an existing recipe to associate with the project.","type":"string","minLength":1,"maxLength":255},"Sample":{"description":"Represents the sample size and sampling type for DataBrew to use for interactive data analysis.","type":"object","properties":{"Size":{"allOf":[{"$ref":"#/components/schemas/SampleSize"},{"description":"The number of rows in the sample."}]},"Type":{"allOf":[{"$ref":"#/components/schemas/SampleType"},{"description":"The way in which DataBrew obtains rows from a dataset."}]}}},"RoleArn":{"description":"The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role to be assumed for this request.","type":"string","minLength":20,"maxLength":2048},"Tags":{"description":"Metadata tags to apply to this project.","type":"object","minProperties":1,"maxProperties":200,"additionalProperties":{"$ref":"#/components/schemas/TagValue"}}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"ListProjects","description":"Lists all of the DataBrew projects that are defined.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListProjectsResponse"}}}},"480":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"nextToken","in":"query","required":false,"description":"The token returned by a previous call to retrieve the next set of results.","schema":{"type":"string","minLength":1,"maxLength":2000}},{"name":"maxResults","in":"query","required":false,"description":"The maximum number of results to return in this request. ","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"MaxResults","in":"query","schema":{"type":"string"},"description":"Pagination limit","required":false},{"name":"NextToken","in":"query","schema":{"type":"string"},"description":"Pagination token","required":false}]}},"/recipes":{"post":{"operationId":"CreateRecipe","description":"Creates a new DataBrew recipe.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRecipeResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ServiceQuotaExceededException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceQuotaExceededException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["Name","Steps"],"properties":{"Description":{"description":"A description for the recipe.","type":"string","maxLength":1024},"Name":{"description":"A unique name for the recipe. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.","type":"string","minLength":1,"maxLength":255},"Steps":{"description":"An array containing the steps to be performed by the recipe. Each recipe step consists of one recipe action and (optionally) an array of condition expressions.","type":"array","items":{"$ref":"#/components/schemas/RecipeStep"}},"Tags":{"description":"Metadata tags to apply to this recipe.","type":"object","minProperties":1,"maxProperties":200,"additionalProperties":{"$ref":"#/components/schemas/TagValue"}}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"ListRecipes","description":"Lists all of the DataBrew recipes that are defined.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRecipesResponse"}}}},"480":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"maxResults","in":"query","required":false,"description":"The maximum number of results to return in this request. ","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"nextToken","in":"query","required":false,"description":"The token returned by a previous call to retrieve the next set of results.","schema":{"type":"string","minLength":1,"maxLength":2000}},{"name":"recipeVersion","in":"query","required":false,"description":"Return only those recipes with a version identifier of <code>LATEST_WORKING</code> or <code>LATEST_PUBLISHED</code>. If <code>RecipeVersion</code> is omitted, <code>ListRecipes</code> returns all of the <code>LATEST_PUBLISHED</code> recipe versions. Valid values: <code>LATEST_WORKING</code> | <code>LATEST_PUBLISHED</code> ","schema":{"type":"string","minLength":1,"maxLength":16}},{"name":"MaxResults","in":"query","schema":{"type":"string"},"description":"Pagination limit","required":false},{"name":"NextToken","in":"query","schema":{"type":"string"},"description":"Pagination token","required":false}]}},"/recipeJobs":{"post":{"operationId":"CreateRecipeJob","description":"Creates a new job to transform input data, using steps defined in an existing Glue DataBrew recipe","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRecipeJobResponse"}}}},"480":{"description":"AccessDeniedException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedException"}}}},"481":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"482":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"483":{"description":"ServiceQuotaExceededException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceQuotaExceededException"}}}},"484":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["Name","RoleArn"],"properties":{"DatasetName":{"description":"The name of the dataset that this job processes.","type":"string","minLength":1,"maxLength":255},"EncryptionKeyArn":{"description":"The Amazon Resource Name (ARN) of an encryption key that is used to protect the job.","type":"string","minLength":20,"maxLength":2048},"EncryptionMode":{"description":"The encryption mode for the job, which can be one of the following: <ul> <li> <code>SSE-KMS</code> - Server-side encryption with keys managed by KMS. </li> <li> <code>SSE-S3</code> - Server-side encryption with keys managed by Amazon S3. </li> </ul>","type":"string","enum":["SSE-KMS","SSE-S3"]},"Name":{"description":"A unique name for the job. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.","type":"string","minLength":1,"maxLength":240},"LogSubscription":{"description":"Enables or disables Amazon CloudWatch logging for the job. If logging is enabled, CloudWatch writes one log stream for each job run.","type":"string","enum":["ENABLE","DISABLE"]},"MaxCapacity":{"description":"The maximum number of nodes that DataBrew can consume when the job processes data.","type":"integer"},"MaxRetries":{"description":"The maximum number of times to retry the job after a job run fails.","type":"integer","minimum":0},"Outputs":{"description":"One or more artifacts that represent the output from running the job.","type":"array","items":{"$ref":"#/components/schemas/Output"},"minItems":1},"DataCatalogOutputs":{"description":"One or more artifacts that represent the Glue Data Catalog output from running the job.","type":"array","items":{"$ref":"#/components/schemas/DataCatalogOutput"},"minItems":1},"DatabaseOutputs":{"description":"Represents a list of JDBC database output objects which defines the output destination for a DataBrew recipe job to write to. ","type":"array","items":{"$ref":"#/components/schemas/DatabaseOutput"},"minItems":1},"ProjectName":{"description":"Either the name of an existing project, or a combination of a recipe and a dataset to associate with the recipe.","type":"string","minLength":1,"maxLength":255},"RecipeReference":{"description":"Represents the name and version of a DataBrew recipe.","type":"object","properties":{"Name":{"allOf":[{"$ref":"#/components/schemas/RecipeName"},{"description":"The name of the recipe."}]},"RecipeVersion":{"allOf":[{"$ref":"#/components/schemas/RecipeVersion"},{"description":"The identifier for the version for the recipe. "}]}}},"RoleArn":{"description":"The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role to be assumed when DataBrew runs the job.","type":"string","minLength":20,"maxLength":2048},"Tags":{"description":"Metadata tags to apply to this job.","type":"object","minProperties":1,"maxProperties":200,"additionalProperties":{"$ref":"#/components/schemas/TagValue"}},"Timeout":{"description":"The job's timeout in minutes. A job that attempts to run longer than this timeout period ends with a status of <code>TIMEOUT</code>.","type":"integer","minimum":0}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}]},"/rulesets":{"post":{"operationId":"CreateRuleset","description":"Creates a new ruleset that can be used in a profile job to validate the data quality of a dataset.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRulesetResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ServiceQuotaExceededException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceQuotaExceededException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["Name","TargetArn","Rules"],"properties":{"Name":{"description":"The name of the ruleset to be created. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.","type":"string","minLength":1,"maxLength":255},"Description":{"description":"The description of the ruleset.","type":"string","maxLength":1024},"TargetArn":{"description":"The Amazon Resource Name (ARN) of a resource (dataset) that the ruleset is associated with.","type":"string","minLength":20,"maxLength":2048},"Rules":{"description":"A list of rules that are defined with the ruleset. A rule includes one or more checks to be validated on a DataBrew dataset.","type":"array","items":{"$ref":"#/components/schemas/Rule"},"minItems":1},"Tags":{"description":"Metadata tags to apply to the ruleset.","type":"object","minProperties":1,"maxProperties":200,"additionalProperties":{"$ref":"#/components/schemas/TagValue"}}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"ListRulesets","description":"List all rulesets available in the current account or rulesets associated with a specific resource (dataset).","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRulesetsResponse"}}}},"480":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"481":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"targetArn","in":"query","required":false,"description":"The Amazon Resource Name (ARN) of a resource (dataset). Using this parameter indicates to return only those rulesets that are associated with the specified resource.","schema":{"type":"string","minLength":20,"maxLength":2048}},{"name":"maxResults","in":"query","required":false,"description":"The maximum number of results to return in this request.","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"nextToken","in":"query","required":false,"description":"A token generated by DataBrew that specifies where to continue pagination if a previous request was truncated. To get the next set of pages, pass in the NextToken value from the response object of the previous page call.","schema":{"type":"string","minLength":1,"maxLength":2000}},{"name":"MaxResults","in":"query","schema":{"type":"string"},"description":"Pagination limit","required":false},{"name":"NextToken","in":"query","schema":{"type":"string"},"description":"Pagination token","required":false}]}},"/schedules":{"post":{"operationId":"CreateSchedule","description":"Creates a new schedule for one or more DataBrew jobs. Jobs can be run at a specific date and time, or at regular intervals.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateScheduleResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ServiceQuotaExceededException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceQuotaExceededException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CronExpression","Name"],"properties":{"JobNames":{"description":"The name or names of one or more jobs to be run.","type":"array","items":{"$ref":"#/components/schemas/JobName"},"maxItems":50},"CronExpression":{"description":"The date or dates and time or times when the jobs are to be run. For more information, see <a href=\"https://docs.aws.amazon.com/databrew/latest/dg/jobs.cron.html\">Cron expressions</a> in the Glue DataBrew Developer Guide.","type":"string","minLength":1,"maxLength":512},"Tags":{"description":"Metadata tags to apply to this schedule.","type":"object","minProperties":1,"maxProperties":200,"additionalProperties":{"$ref":"#/components/schemas/TagValue"}},"Name":{"description":"A unique name for the schedule. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.","type":"string","minLength":1,"maxLength":255}}}}}}},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"ListSchedules","description":"Lists the DataBrew schedules that are defined.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListSchedulesResponse"}}}},"480":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"jobName","in":"query","required":false,"description":"The name of the job that these schedules apply to.","schema":{"type":"string","minLength":1,"maxLength":240}},{"name":"maxResults","in":"query","required":false,"description":"The maximum number of results to return in this request. ","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"nextToken","in":"query","required":false,"description":"The token returned by a previous call to retrieve the next set of results.","schema":{"type":"string","minLength":1,"maxLength":2000}},{"name":"MaxResults","in":"query","schema":{"type":"string"},"description":"Pagination limit","required":false},{"name":"NextToken","in":"query","schema":{"type":"string"},"description":"Pagination token","required":false}]}},"/datasets/{name}":{"delete":{"operationId":"DeleteDataset","description":"Deletes a dataset from DataBrew.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteDatasetResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the dataset to be deleted.","schema":{"type":"string","minLength":1,"maxLength":255}}]},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"DescribeDataset","description":"Returns the definition of a specific DataBrew dataset.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DescribeDatasetResponse"}}}},"480":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"481":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the dataset to be described.","schema":{"type":"string","minLength":1,"maxLength":255}}]},"put":{"operationId":"UpdateDataset","description":"Modifies the definition of an existing DataBrew dataset.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDatasetResponse"}}}},"480":{"description":"AccessDeniedException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedException"}}}},"481":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the dataset to be updated.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["Input"],"properties":{"Format":{"description":"The file format of a dataset that is created from an Amazon S3 file or folder.","type":"string","enum":["CSV","JSON","PARQUET","EXCEL","ORC"]},"FormatOptions":{"description":"Represents a set of options that define the structure of either comma-separated value (CSV), Excel, or JSON input.","type":"object","properties":{"Json":{"allOf":[{"$ref":"#/components/schemas/JsonOptions"},{"description":"Options that define how JSON input is to be interpreted by DataBrew."}]},"Excel":{"allOf":[{"$ref":"#/components/schemas/ExcelOptions"},{"description":"Options that define how Excel input is to be interpreted by DataBrew."}]},"Csv":{"allOf":[{"$ref":"#/components/schemas/CsvOptions"},{"description":"Options that define how CSV input is to be interpreted by DataBrew."}]}}},"Input":{"description":"Represents information on how DataBrew can find data, in either the Glue Data Catalog or Amazon S3.","type":"object","properties":{"S3InputDefinition":{"allOf":[{"$ref":"#/components/schemas/S3Location"},{"description":"The Amazon S3 location where the data is stored."}]},"DataCatalogInputDefinition":{"allOf":[{"$ref":"#/components/schemas/DataCatalogInputDefinition"},{"description":"The Glue Data Catalog parameters for the data."}]},"DatabaseInputDefinition":{"allOf":[{"$ref":"#/components/schemas/DatabaseInputDefinition"},{"description":"Connection information for dataset input files stored in a database."}]},"Metadata":{"allOf":[{"$ref":"#/components/schemas/Metadata"},{"description":"Contains additional resource information needed for specific datasets."}]}}},"PathOptions":{"description":"Represents a set of options that define how DataBrew selects files for a given Amazon S3 path in a dataset.","type":"object","properties":{"LastModifiedDateCondition":{"allOf":[{"$ref":"#/components/schemas/FilterExpression"},{"description":"If provided, this structure defines a date range for matching Amazon S3 objects based on their LastModifiedDate attribute in Amazon S3."}]},"FilesLimit":{"allOf":[{"$ref":"#/components/schemas/FilesLimit"},{"description":"If provided, this structure imposes a limit on a number of files that should be selected."}]},"Parameters":{"allOf":[{"$ref":"#/components/schemas/PathParametersMap"},{"description":"A structure that maps names of parameters used in the Amazon S3 path of a dataset to their definitions."}]}}}}}}}}}},"/jobs/{name}":{"delete":{"operationId":"DeleteJob","description":"Deletes the specified DataBrew job.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteJobResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the job to be deleted.","schema":{"type":"string","minLength":1,"maxLength":240}}]},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"DescribeJob","description":"Returns the definition of a specific DataBrew job.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DescribeJobResponse"}}}},"480":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"481":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the job to be described.","schema":{"type":"string","minLength":1,"maxLength":240}}]}},"/projects/{name}":{"delete":{"operationId":"DeleteProject","description":"Deletes an existing DataBrew project.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteProjectResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the project to be deleted.","schema":{"type":"string","minLength":1,"maxLength":255}}]},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"DescribeProject","description":"Returns the definition of a specific DataBrew project.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DescribeProjectResponse"}}}},"480":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"481":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the project to be described.","schema":{"type":"string","minLength":1,"maxLength":255}}]},"put":{"operationId":"UpdateProject","description":"Modifies the definition of an existing DataBrew project.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProjectResponse"}}}},"480":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"481":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the project to be updated.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["RoleArn"],"properties":{"Sample":{"description":"Represents the sample size and sampling type for DataBrew to use for interactive data analysis.","type":"object","properties":{"Size":{"allOf":[{"$ref":"#/components/schemas/SampleSize"},{"description":"The number of rows in the sample."}]},"Type":{"allOf":[{"$ref":"#/components/schemas/SampleType"},{"description":"The way in which DataBrew obtains rows from a dataset."}]}}},"RoleArn":{"description":"The Amazon Resource Name (ARN) of the IAM role to be assumed for this request.","type":"string","minLength":20,"maxLength":2048}}}}}}}},"/recipes/{name}/recipeVersion/{recipeVersion}":{"delete":{"operationId":"DeleteRecipeVersion","description":"Deletes a single version of a DataBrew recipe.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRecipeVersionResponse"}}}},"480":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}},"481":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"482":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the recipe.","schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"recipeVersion","in":"path","required":true,"description":"The version of the recipe to be deleted. You can specify a numeric versions (<code>X.Y</code>) or <code>LATEST_WORKING</code>. <code>LATEST_PUBLISHED</code> is not supported.","schema":{"type":"string","minLength":1,"maxLength":16}}]},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}]},"/rulesets/{name}":{"delete":{"operationId":"DeleteRuleset","description":"Deletes a ruleset.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRulesetResponse"}}}},"480":{"description":"ResourceNotFoundException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundException"}}}},"481":{"description":"ValidationException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationException"}}}},"482":{"description":"ConflictException","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictException"}}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the ruleset to be deleted.","schema":{"type":"string","minLength":1,"maxLength":255}}]},"parameters":[{"$ref":"#/components/parameters/X-Amz-Content-Sha256"},{"$ref":"#/components/parameters/X-Amz-Date"},{"$ref":"#/components/parameters/X-Amz-Algorithm"},{"$ref":"#/components/parameters/X-Amz-Credential"},{"$ref":"#/components/parameters/X-Amz-Security-Token"},{"$ref":"#/components/parameters/X-Amz-Signature"},{"$ref":"#/components/parameters/X-Amz-SignedHeaders"}],"get":{"operationId":"Describe