issue or
+ project, are available in context and sets their
+ type. Use this property to override the default types or provide
+ details of new variables.
+ type: string
+ description: Context variables and their types. The type checker assumes that
+ [common context
+ variables](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#context-variables),
+ such as `issue` or `project`, are available in context and sets
+ their type. Use this property to override the default types or
+ provide details of new variables.
+ type: object
+ expressions:
+ description: The list of Jira expressions to analyse.
+ example: issues.map(issue => issue.properties['property_key'])
+ items:
+ description: The list of Jira expressions to analyse.
+ example: issues.map(issue => issue.properties['property_key'])
+ type: string
+ type: array
+ required:
+ - expressions
+ type: object
+ JiraExpressionResult:
+ additionalProperties: false
+ description: The result of evaluating a Jira expression.
+ properties:
+ meta:
+ allOf:
+ - $ref: "#/components/schemas/JiraExpressionEvaluationMetaDataBean"
+ description: Contains various characteristics of the performed expression
+ evaluation.
+ value:
+ description: The value of the evaluated expression. It may be a primitive JSON
+ value or a Jira REST API object. (Some expressions do not produce
+ any meaningful results—for example, an expression that returns a
+ lambda function—if that's the case a simple string representation is
+ returned. These string representations should not be relied upon and
+ may change without notice.)
+ required:
+ - value
+ type: object
+ JiraExpressionValidationError:
+ additionalProperties: false
+ description: >-
+ Details about syntax and type errors. The error details apply to
+ the entire expression, unless the object includes:
+
+ * `line` and `column`
+ * `expression`
+ properties:
+ column:
+ description: The text column in which the error occurred.
+ format: int32
+ type: integer
+ expression:
+ description: The part of the expression in which the error occurred.
+ type: string
+ line:
+ description: The text line in which the error occurred.
+ format: int32
+ type: integer
+ message:
+ description: Details about the error.
+ example: "!, -, typeof, (, IDENTIFIER, null, true, false, NUMBER, STRING,
+ TEMPLATE_LITERAL, new, [ or { expected, > encountered."
+ type: string
+ type:
+ description: The error type.
+ enum:
+ - syntax
+ - type
+ - other
+ type: string
+ required:
+ - message
+ - type
+ type: object
+ JiraExpressionsAnalysis:
+ additionalProperties: false
+ description: Details about the analysed Jira expression.
+ properties:
+ results:
+ description: The results of Jira expressions analysis.
+ items:
+ $ref: "#/components/schemas/JiraExpressionAnalysis"
+ type: array
+ required:
+ - results
+ type: object
+ JiraExpressionsComplexityBean:
+ additionalProperties: false
+ properties:
+ beans:
+ allOf:
+ - $ref: "#/components/schemas/JiraExpressionsComplexityValueBean"
+ description: The number of Jira REST API beans returned in the response.
+ expensiveOperations:
+ allOf:
+ - $ref: "#/components/schemas/JiraExpressionsComplexityValueBean"
+ description: The number of expensive operations executed while evaluating the
+ expression. Expensive operations are those that load additional
+ data, such as entity properties, comments, or custom fields.
+ primitiveValues:
+ allOf:
+ - $ref: "#/components/schemas/JiraExpressionsComplexityValueBean"
+ description: The number of primitive values returned in the response.
+ steps:
+ allOf:
+ - $ref: "#/components/schemas/JiraExpressionsComplexityValueBean"
+ description: The number of steps it took to evaluate the expression, where a
+ step is a high-level operation performed by the expression. A step
+ is an operation such as arithmetic, accessing a property, accessing
+ a context variable, or calling a function.
+ required:
+ - beans
+ - expensiveOperations
+ - primitiveValues
+ - steps
+ type: object
+ JiraExpressionsComplexityValueBean:
+ additionalProperties: false
+ properties:
+ limit:
+ description: The maximum allowed complexity. The evaluation will fail if this
+ value is exceeded.
+ format: int32
+ type: integer
+ value:
+ description: The complexity value of the current expression.
+ format: int32
+ type: integer
+ required:
+ - limit
+ - value
+ type: object
+ JqlQueriesToParse:
+ additionalProperties: false
+ description: A list of JQL queries to parse.
+ properties:
+ queries:
+ description: A list of queries to parse.
+ items:
+ minLength: 1
+ type: string
+ minLength: 1
+ type: array
+ required:
+ - queries
+ type: object
+ writeOnly: true
+ JqlQuery:
+ additionalProperties: false
+ description: A parsed JQL query.
+ properties:
+ orderBy:
+ $ref: "#/components/schemas/JqlQueryOrderByClause"
+ where:
+ $ref: "#/components/schemas/JqlQueryClause"
+ type: object
+ JqlQueryClause:
+ additionalProperties: false
+ anyOf:
+ - $ref: "#/components/schemas/CompoundClause"
+ - $ref: "#/components/schemas/FieldValueClause"
+ - $ref: "#/components/schemas/FieldWasClause"
+ - $ref: "#/components/schemas/FieldChangedClause"
+ description: A JQL query clause.
+ type: object
+ JqlQueryClauseOperand:
+ anyOf:
+ - $ref: "#/components/schemas/ListOperand"
+ - $ref: "#/components/schemas/ValueOperand"
+ - $ref: "#/components/schemas/FunctionOperand"
+ - $ref: "#/components/schemas/KeywordOperand"
+ description: Details of an operand in a JQL clause.
+ type: object
+ JqlQueryClauseTimePredicate:
+ description: A time predicate for a temporal JQL clause.
+ properties:
+ operand:
+ $ref: "#/components/schemas/JqlQueryClauseOperand"
+ operator:
+ description: The operator between the field and the operand.
+ enum:
+ - before
+ - after
+ - from
+ - to
+ - on
+ - during
+ - by
+ type: string
+ required:
+ - operand
+ - operator
+ type: object
+ JqlQueryField:
+ additionalProperties: false
+ description: A field used in a JQL query. See [Advanced searching - fields
+ reference](https://confluence.atlassian.com/x/dAiiLQ) for more
+ information about fields in JQL queries.
+ properties:
+ name:
+ description: The name of the field.
+ type: string
+ property:
+ description: When the field refers to a value in an entity property, details of
+ the entity property value.
+ items:
+ $ref: "#/components/schemas/JqlQueryFieldEntityProperty"
+ type: array
+ required:
+ - name
+ type: object
+ JqlQueryFieldEntityProperty:
+ description: Details of an entity property.
+ properties:
+ entity:
+ description: The object on which the property is set.
+ example: issue
+ type: string
+ key:
+ description: The key of the property.
+ example: stats
+ type: string
+ path:
+ description: The path in the property value to query.
+ example: comments.count
+ type: string
+ type:
+ description: The type of the property value extraction. Not available if the
+ extraction for the property is not registered on the instance with
+ the [Entity
+ property](https://developer.atlassian.com/cloud/jira/platform/modules/entity-property/)
+ module.
+ enum:
+ - number
+ - string
+ - text
+ - date
+ - user
+ example: number
+ type: string
+ required:
+ - entity
+ - key
+ - path
+ type: object
+ JqlQueryOrderByClause:
+ additionalProperties: false
+ description: Details of the order-by JQL clause.
+ properties:
+ fields:
+ description: The list of order-by clause fields and their ordering directives.
+ items:
+ $ref: "#/components/schemas/JqlQueryOrderByClauseElement"
+ type: array
+ required:
+ - fields
+ type: object
+ JqlQueryOrderByClauseElement:
+ additionalProperties: false
+ description: An element of the order-by JQL clause.
+ properties:
+ direction:
+ description: The direction in which to order the results.
+ enum:
+ - asc
+ - desc
+ type: string
+ field:
+ $ref: "#/components/schemas/JqlQueryField"
+ required:
+ - field
+ type: object
+ JqlQueryUnitaryOperand:
+ anyOf:
+ - $ref: "#/components/schemas/ValueOperand"
+ - $ref: "#/components/schemas/FunctionOperand"
+ - $ref: "#/components/schemas/KeywordOperand"
+ description: An operand that can be part of a list operand.
+ type: object
+ JsonNode:
+ additionalProperties: false
+ maxProperties: 10
+ minProperties: 1
+ properties:
+ array:
+ type: boolean
+ bigDecimal:
+ type: boolean
+ bigInteger:
+ type: boolean
+ bigIntegerValue:
+ type: integer
+ binary:
+ type: boolean
+ binaryValue:
+ items:
+ format: byte
+ type: string
+ type: array
+ boolean:
+ type: boolean
+ booleanValue:
+ type: boolean
+ containerNode:
+ type: boolean
+ decimalValue:
+ type: number
+ double:
+ type: boolean
+ doubleValue:
+ format: double
+ type: number
+ elements:
+ type: object
+ fieldNames:
+ type: object
+ fields:
+ type: object
+ floatingPointNumber:
+ type: boolean
+ int:
+ type: boolean
+ intValue:
+ format: int32
+ type: integer
+ integralNumber:
+ type: boolean
+ long:
+ type: boolean
+ longValue:
+ format: int64
+ type: integer
+ missingNode:
+ type: boolean
+ "null":
+ type: boolean
+ number:
+ type: boolean
+ numberType:
+ enum:
+ - INT
+ - LONG
+ - BIG_INTEGER
+ - FLOAT
+ - DOUBLE
+ - BIG_DECIMAL
+ type: string
+ numberValue:
+ type: number
+ object:
+ type: boolean
+ pojo:
+ type: boolean
+ textValue:
+ type: string
+ textual:
+ type: boolean
+ valueAsBoolean:
+ type: boolean
+ valueAsDouble:
+ format: double
+ type: number
+ valueAsInt:
+ format: int32
+ type: integer
+ valueAsLong:
+ format: int64
+ type: integer
+ valueAsText:
+ type: string
+ valueNode:
+ type: boolean
+ type: object
+ JsonTypeBean:
+ additionalProperties: false
+ description: The schema of a field.
+ properties:
+ configuration:
+ additionalProperties:
+ readOnly: true
+ description: If the field is a custom field, the configuration of the field.
+ readOnly: true
+ type: object
+ custom:
+ description: If the field is a custom field, the URI of the field.
+ readOnly: true
+ type: string
+ customId:
+ description: If the field is a custom field, the custom ID of the field.
+ format: int64
+ readOnly: true
+ type: integer
+ items:
+ description: When the data type is an array, the name of the field items within
+ the array.
+ readOnly: true
+ type: string
+ system:
+ description: If the field is a system field, the name of the field.
+ readOnly: true
+ type: string
+ type:
+ description: The data type of the field.
+ readOnly: true
+ type: string
+ required:
+ - type
+ type: object
+ KeywordOperand:
+ description: An operand that is a JQL keyword. See [Advanced searching -
+ keywords
+ reference](https://confluence.atlassian.com/jiracorecloud/advanced-searching-keywords-reference-765593717.html#Advancedsearching-keywordsreference-EMPTYEMPTY)
+ for more information about operand keywords.
+ properties:
+ keyword:
+ description: The keyword that is the operand value.
+ enum:
+ - empty
+ type: string
+ required:
+ - keyword
+ type: object
+ License:
+ additionalProperties: false
+ description: Details about a license for the Jira instance.
+ properties:
+ applications:
+ description: The applications under this license.
+ items:
+ $ref: "#/components/schemas/LicensedApplication"
+ readOnly: true
+ type: array
+ required:
+ - applications
+ type: object
+ LicensedApplication:
+ additionalProperties: false
+ description: Details about a licensed Jira application.
+ properties:
+ id:
+ description: The ID of the application.
+ readOnly: true
+ type: string
+ plan:
+ description: The licensing plan.
+ enum:
+ - UNLICENSED
+ - FREE
+ - PAID
+ readOnly: true
+ type: string
+ required:
+ - id
+ - plan
+ type: object
+ LinkGroup:
+ additionalProperties: false
+ description: Details a link group, which defines issue operations.
+ properties:
+ groups:
+ items:
+ $ref: "#/components/schemas/LinkGroup"
+ type: array
+ header:
+ $ref: "#/components/schemas/SimpleLink"
+ id:
+ type: string
+ links:
+ items:
+ $ref: "#/components/schemas/SimpleLink"
+ type: array
+ styleClass:
+ type: string
+ weight:
+ format: int32
+ type: integer
+ type: object
+ LinkIssueRequestJsonBean:
+ additionalProperties: false
+ properties:
+ comment:
+ $ref: "#/components/schemas/Comment"
+ inwardIssue:
+ $ref: "#/components/schemas/LinkedIssue"
+ outwardIssue:
+ $ref: "#/components/schemas/LinkedIssue"
+ type:
+ $ref: "#/components/schemas/IssueLinkType"
+ required:
+ - inwardIssue
+ - outwardIssue
+ - type
+ type: object
+ LinkedIssue:
+ additionalProperties: false
+ description: The ID or key of a linked issue.
+ properties:
+ fields:
+ allOf:
+ - $ref: "#/components/schemas/Fields"
+ description: The fields associated with the issue.
+ readOnly: true
+ id:
+ description: The ID of an issue. Required if `key` isn't provided.
+ type: string
+ key:
+ description: The key of an issue. Required if `id` isn't provided.
+ type: string
+ self:
+ description: The URL of the issue.
+ format: uri
+ readOnly: true
+ type: string
+ type: object
+ ListOperand:
+ description: An operand that is a list of values.
+ properties:
+ values:
+ description: The list of operand values.
+ items:
+ $ref: "#/components/schemas/JqlQueryUnitaryOperand"
+ minLength: 1
+ type: array
+ required:
+ - values
+ type: object
+ ListWrapperCallbackApplicationRole:
+ additionalProperties: false
+ type: object
+ ListWrapperCallbackGroupName:
+ additionalProperties: false
+ type: object
+ Locale:
+ additionalProperties: false
+ description: Details of a locale.
+ properties:
+ locale:
+ description: "The locale code. The Java the locale format is used: a two
+ character language code (ISO 639), an underscore, and two letter
+ country code (ISO 3166). For example, en\\_US represents a locale of
+ English (United States). Required on create."
+ type: string
+ type: object
+ MoveFieldBean:
+ additionalProperties: false
+ properties:
+ after:
+ description: The ID of the screen tab field after which to place the moved
+ screen tab field. Required if `position` isn't provided.
+ format: uri
+ type: string
+ position:
+ description: The named position to which the screen tab field should be moved.
+ Required if `after` isn't provided.
+ enum:
+ - Earlier
+ - Later
+ - First
+ - Last
+ type: string
+ type: object
+ NestedResponse:
+ additionalProperties: false
+ properties:
+ errorCollection:
+ $ref: "#/components/schemas/ErrorCollection"
+ status:
+ format: int32
+ type: integer
+ type: object
+ Notification:
+ additionalProperties: true
+ description: Details about a notification.
+ properties:
+ htmlBody:
+ description: The HTML body of the email notification for the issue.
+ type: string
+ restrict:
+ allOf:
+ - $ref: "#/components/schemas/NotificationRecipientsRestrictions"
+ description: Restricts the notifications to users with the specified permissions.
+ subject:
+ description: The subject of the email notification for the issue. If this is not
+ specified, then the subject is set to the issue key and summary.
+ type: string
+ textBody:
+ description: The plain text body of the email notification for the issue.
+ type: string
+ to:
+ allOf:
+ - $ref: "#/components/schemas/NotificationRecipients"
+ description: The recipients of the email notification for the issue.
+ type: object
+ NotificationEvent:
+ additionalProperties: false
+ description: Details about a notification event.
+ properties:
+ description:
+ description: The description of the event.
+ type: string
+ id:
+ description: The ID of the event. The event can be a [Jira system
+ event](https://confluence.atlassian.com/x/8YdKLg#Creatinganotificationscheme-eventsEvents)
+ or a [custom event](https://confluence.atlassian.com/x/AIlKLg).
+ format: int64
+ type: integer
+ name:
+ description: The name of the event.
+ type: string
+ templateEvent:
+ allOf:
+ - $ref: "#/components/schemas/NotificationEvent"
+ description: The template of the event. Only custom events configured by Jira
+ administrators have template.
+ type: object
+ NotificationRecipients:
+ additionalProperties: true
+ description: Details of the users and groups to receive the notification.
+ properties:
+ assignee:
+ description: Whether the notification should be sent to the issue's assignees.
+ type: boolean
+ groups:
+ description: List of groups to receive the notification.
+ items:
+ $ref: "#/components/schemas/GroupName"
+ type: array
+ reporter:
+ description: Whether the notification should be sent to the issue's reporter.
+ type: boolean
+ users:
+ description: List of users to receive the notification.
+ items:
+ $ref: "#/components/schemas/UserDetails"
+ type: array
+ voters:
+ description: Whether the notification should be sent to the issue's voters.
+ type: boolean
+ watchers:
+ description: Whether the notification should be sent to the issue's watchers.
+ type: boolean
+ type: object
+ NotificationRecipientsRestrictions:
+ additionalProperties: false
+ description: Details of the group membership or permissions needed to receive
+ the notification.
+ properties:
+ groups:
+ description: List of group memberships required to receive the notification.
+ items:
+ $ref: "#/components/schemas/GroupName"
+ type: array
+ permissions:
+ description: List of permissions required to receive the notification.
+ items:
+ $ref: "#/components/schemas/RestrictedPermission"
+ type: array
+ type: object
+ NotificationScheme:
+ additionalProperties: false
+ description: Details about a notification scheme.
+ properties:
+ description:
+ description: The description of the notification scheme.
+ type: string
+ expand:
+ description: Expand options that include additional notification scheme details
+ in the response.
+ type: string
+ id:
+ description: The ID of the notification scheme.
+ format: int64
+ type: integer
+ name:
+ description: The name of the notification scheme.
+ type: string
+ notificationSchemeEvents:
+ description: The notification events and associated recipients.
+ items:
+ $ref: "#/components/schemas/NotificationSchemeEvent"
+ type: array
+ scope:
+ allOf:
+ - $ref: "#/components/schemas/Scope"
+ description: The scope of the notification scheme.
+ self:
+ type: string
+ type: object
+ NotificationSchemeEvent:
+ additionalProperties: false
+ description: Details about a notification scheme event.
+ properties:
+ event:
+ $ref: "#/components/schemas/NotificationEvent"
+ notifications:
+ items:
+ $ref: "#/components/schemas/EventNotification"
+ type: array
+ type: object
+ OperationMessage:
+ additionalProperties: false
+ example:
+ message: An example message.
+ statusCode: 200
+ properties:
+ message:
+ description: The human-readable message that describes the result.
+ type: string
+ statusCode:
+ description: The status code of the response.
+ type: integer
+ required:
+ - message
+ - statusCode
+ type: object
+ Operations:
+ additionalProperties: true
+ description: Details of the operations that can be performed on the issue.
+ properties:
+ linkGroups:
+ description: Details of the link groups defining issue operations.
+ items:
+ $ref: "#/components/schemas/LinkGroup"
+ readOnly: true
+ type: array
+ type: object
+ OrderOfCustomFieldOptions:
+ additionalProperties: false
+ description: An ordered list of custom field option IDs and information on where
+ to move them.
+ properties:
+ after:
+ description: The ID of the custom field option or cascading option to place the
+ moved options after. Required if `position` isn't provided.
+ type: string
+ writeOnly: true
+ customFieldOptionIds:
+ description: A list of IDs of custom field options to move. The order of the
+ custom field option IDs in the list is the order they are given
+ after the move. The list must contain custom field options or
+ cascading options, but not both.
+ items:
+ type: string
+ writeOnly: true
+ type: array
+ writeOnly: true
+ position:
+ description: The position the custom field options should be moved to. Required
+ if `after` isn't provided.
+ enum:
+ - First
+ - Last
+ type: string
+ writeOnly: true
+ required:
+ - customFieldOptionIds
+ type: object
+ OrderOfIssueTypes:
+ additionalProperties: false
+ description: An ordered list of issue type IDs and information about where to
+ move them.
+ properties:
+ after:
+ description: The ID of the issue type to place the moved issue types after.
+ Required if `position` isn't provided.
+ type: string
+ writeOnly: true
+ issueTypeIds:
+ description: A list of the issue type IDs to move. The order of the issue type
+ IDs in the list is the order they are given after the move.
+ items:
+ type: string
+ writeOnly: true
+ type: array
+ writeOnly: true
+ position:
+ description: The position the issue types should be moved to. Required if
+ `after` isn't provided.
+ enum:
+ - First
+ - Last
+ type: string
+ writeOnly: true
+ required:
+ - issueTypeIds
+ type: object
+ PageBeanChangelog:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Changelog"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanComment:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Comment"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanComponentWithIssueCount:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/ComponentWithIssueCount"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanContext:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Context"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanContextForProjectAndIssueType:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/ContextForProjectAndIssueType"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanCustomFieldContext:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/CustomFieldContext"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanCustomFieldContextDefaultValue:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/CustomFieldContextDefaultValue"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanCustomFieldContextOption:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/CustomFieldContextOption"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanCustomFieldContextProjectMapping:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/CustomFieldContextProjectMapping"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanCustomFieldOptionDetails:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/CustomFieldOptionDetails"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanDashboard:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Dashboard"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanField:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Field"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanFieldConfiguration:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/FieldConfiguration"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanFieldConfigurationIssueTypeItem:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/FieldConfigurationIssueTypeItem"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanFieldConfigurationItem:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/FieldConfigurationItem"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanFieldConfigurationScheme:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/FieldConfigurationScheme"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanFieldConfigurationSchemeProjects:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/FieldConfigurationSchemeProjects"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanFilterDetails:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/FilterDetails"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanGroupDetails:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/GroupDetails"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueFieldOption:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueFieldOption"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueSecurityLevelMember:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueSecurityLevelMember"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueTypeScheme:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueTypeScheme"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueTypeSchemeMapping:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueTypeSchemeMapping"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueTypeSchemeProjects:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueTypeSchemeProjects"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueTypeScreenScheme:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueTypeScreenScheme"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueTypeScreenSchemeItem:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueTypeScreenSchemeItem"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueTypeScreenSchemesProjects:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueTypeScreenSchemesProjects"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanIssueTypeToContextMapping:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/IssueTypeToContextMapping"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanNotificationScheme:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/NotificationScheme"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanProject:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Project"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanScreen:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Screen"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanScreenScheme:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/ScreenScheme"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanScreenWithTab:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/ScreenWithTab"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanString:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ readOnly: true
+ type: string
+ readOnly: true
+ type: array
+ type: object
+ PageBeanUser:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/User"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanUserDetails:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/UserDetails"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanUserKey:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/UserKey"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanVersion:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Version"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanWebhook:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Webhook"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanWorkflow:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/Workflow"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanWorkflowScheme:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/WorkflowScheme"
+ readOnly: true
+ type: array
+ type: object
+ PageBeanWorkflowTransitionRules:
+ additionalProperties: false
+ description: A page of items.
+ properties:
+ isLast:
+ description: Whether this is the last page.
+ readOnly: true
+ type: boolean
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ nextPage:
+ description: If there is another page of results, the URL of the next page.
+ format: uri
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the page.
+ format: uri
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ values:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/WorkflowTransitionRules"
+ readOnly: true
+ type: array
+ type: object
+ PageOfChangelogs:
+ additionalProperties: false
+ description: A page of changelogs.
+ properties:
+ histories:
+ description: The list of changelogs.
+ items:
+ $ref: "#/components/schemas/Changelog"
+ readOnly: true
+ type: array
+ maxResults:
+ description: The maximum number of results that could be on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ startAt:
+ description: The index of the first item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ total:
+ description: The number of results on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ type: object
+ PageOfComments:
+ additionalProperties: true
+ description: A page of comments.
+ properties:
+ comments:
+ description: The list of comments.
+ items:
+ $ref: "#/components/schemas/Comment"
+ readOnly: true
+ type: array
+ maxResults:
+ description: The maximum number of items that could be returned.
+ format: int32
+ readOnly: true
+ type: integer
+ startAt:
+ description: The index of the first item returned.
+ format: int64
+ readOnly: true
+ type: integer
+ total:
+ description: The number of items returned.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ PageOfDashboards:
+ additionalProperties: false
+ description: A page containing dashboard details.
+ properties:
+ dashboards:
+ description: List of dashboards.
+ items:
+ $ref: "#/components/schemas/Dashboard"
+ readOnly: true
+ type: array
+ maxResults:
+ description: The maximum number of results that could be on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ next:
+ description: The URL of the next page of results, if any.
+ readOnly: true
+ type: string
+ prev:
+ description: The URL of the previous page of results, if any.
+ readOnly: true
+ type: string
+ startAt:
+ description: The index of the first item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ total:
+ description: The number of results on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ type: object
+ PageOfWorklogs:
+ additionalProperties: true
+ description: Paginated list of worklog details
+ properties:
+ maxResults:
+ description: The maximum number of results that could be on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ startAt:
+ description: The index of the first item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ total:
+ description: The number of results on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ worklogs:
+ description: List of worklogs.
+ items:
+ $ref: "#/components/schemas/Worklog"
+ readOnly: true
+ type: array
+ type: object
+ PagedListUserDetailsApplicationUser:
+ additionalProperties: false
+ description: A paged list. To access additional details append
+ `[start-index:end-index]` to the expand request. For example,
+ `?expand=sharedUsers[10:40]` returns a list starting at item 10 and
+ finishing at item 40.
+ properties:
+ end-index:
+ description: The index of the last item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ name: end-index
+ items:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/UserDetails"
+ readOnly: true
+ type: array
+ max-results:
+ description: The maximum number of results that could be on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ name: max-results
+ size:
+ description: The number of items on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ start-index:
+ description: The index of the first item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ name: start-index
+ type: object
+ PaginatedResponseComment:
+ additionalProperties: false
+ properties:
+ maxResults:
+ format: int32
+ type: integer
+ results:
+ items:
+ $ref: "#/components/schemas/Comment"
+ type: array
+ startAt:
+ format: int64
+ type: integer
+ total:
+ format: int64
+ type: integer
+ type: object
+ ParsedJqlQueries:
+ additionalProperties: false
+ description: A list of parsed JQL queries.
+ properties:
+ queries:
+ description: A list of parsed JQL queries.
+ items:
+ $ref: "#/components/schemas/ParsedJqlQuery"
+ minLength: 1
+ type: array
+ required:
+ - queries
+ type: object
+ ParsedJqlQuery:
+ additionalProperties: false
+ description: Details of a parsed JQL query.
+ minLength: 1
+ properties:
+ errors:
+ description: The list of syntax or validation errors.
+ items:
+ type: string
+ type: array
+ uniqueItems: true
+ query:
+ description: The JQL query that was parsed and validated.
+ type: string
+ structure:
+ allOf:
+ - $ref: "#/components/schemas/JqlQuery"
+ description: The syntax tree of the query. Empty if the query was invalid.
+ required:
+ - query
+ type: object
+ PermissionGrant:
+ additionalProperties: false
+ description: Details about a permission granted to a user or group.
+ properties:
+ holder:
+ allOf:
+ - $ref: "#/components/schemas/PermissionHolder"
+ description: The user or group being granted the permission. It consists of a
+ `type` and a type-dependent `parameter`. See [Holder
+ object](../api-group-permission-schemes/#holder-object) in *Get all
+ permission schemes* for more information.
+ id:
+ description: The ID of the permission granted details.
+ format: int64
+ readOnly: true
+ type: integer
+ permission:
+ description: The permission to grant. This permission can be one of the built-in
+ permissions or a custom permission added by an app. See [Built-in
+ permissions](../api-group-permission-schemes/#built-in-permissions)
+ in *Get all permission schemes* for more information about the
+ built-in permissions. See the [project
+ permission](https://developer.atlassian.com/cloud/jira/platform/modules/project-permission/)
+ and [global
+ permission](https://developer.atlassian.com/cloud/jira/platform/modules/global-permission/)
+ module documentation for more information about custom permissions.
+ type: string
+ self:
+ description: The URL of the permission granted details.
+ format: uri
+ readOnly: true
+ type: string
+ type: object
+ PermissionGrants:
+ additionalProperties: false
+ description: List of permission grants.
+ properties:
+ expand:
+ description: Expand options that include additional permission grant details in
+ the response.
+ readOnly: true
+ type: string
+ permissions:
+ description: Permission grants list.
+ items:
+ $ref: "#/components/schemas/PermissionGrant"
+ readOnly: true
+ type: array
+ type: object
+ PermissionHolder:
+ additionalProperties: false
+ description: Details of a user, group, field, or project role that holds a
+ permission. See [Holder
+ object](../api-group-permission-schemes/#holder-object) in *Get all
+ permission schemes* for more information.
+ properties:
+ expand:
+ description: Expand options that include additional permission holder details in
+ the response.
+ readOnly: true
+ type: string
+ parameter:
+ description: The identifier of permission holder.
+ type: string
+ type:
+ description: The type of permission holder.
+ type: string
+ required:
+ - type
+ type: object
+ PermissionScheme:
+ additionalProperties: true
+ description: Details of a permission scheme.
+ properties:
+ description:
+ description: A description for the permission scheme.
+ type: string
+ expand:
+ description: The expand options available for the permission scheme.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the permission scheme.
+ format: int64
+ readOnly: true
+ type: integer
+ name:
+ description: The name of the permission scheme. Must be unique.
+ type: string
+ permissions:
+ description: The permission scheme to create or update. See [About permission
+ schemes and
+ grants](../api-group-permission-schemes/#about-permission-schemes-and-grants)
+ for more information.
+ items:
+ $ref: "#/components/schemas/PermissionGrant"
+ type: array
+ scope:
+ allOf:
+ - $ref: "#/components/schemas/Scope"
+ description: The scope of the permission scheme.
+ self:
+ description: The URL of the permission scheme.
+ format: uri
+ readOnly: true
+ type: string
+ required:
+ - name
+ type: object
+ PermissionSchemes:
+ additionalProperties: false
+ description: List of all permission schemes.
+ properties:
+ permissionSchemes:
+ description: Permission schemes list.
+ items:
+ $ref: "#/components/schemas/PermissionScheme"
+ readOnly: true
+ type: array
+ type: object
+ Permissions:
+ additionalProperties: false
+ description: Details about permissions.
+ properties:
+ permissions:
+ additionalProperties:
+ $ref: "#/components/schemas/UserPermission"
+ description: List of permissions.
+ readOnly: true
+ type: object
+ type: object
+ PermissionsKeysBean:
+ additionalProperties: false
+ properties:
+ permissions:
+ description: A list of permission keys.
+ items:
+ type: string
+ type: array
+ required:
+ - permissions
+ type: object
+ PermittedProjects:
+ additionalProperties: false
+ description: A list of projects in which a user is granted permissions.
+ properties:
+ projects:
+ description: A list of projects.
+ items:
+ $ref: "#/components/schemas/ProjectIdentifierBean"
+ readOnly: true
+ type: array
+ type: object
+ Priority:
+ additionalProperties: true
+ description: An issue priority.
+ properties:
+ description:
+ description: The description of the issue priority.
+ type: string
+ iconUrl:
+ description: The URL of the icon for the issue priority.
+ type: string
+ id:
+ description: The ID of the issue priority.
+ type: string
+ name:
+ description: The name of the issue priority.
+ type: string
+ self:
+ description: The URL of the issue priority.
+ type: string
+ statusColor:
+ description: The color used to indicate the issue priority.
+ type: string
+ type: object
+ Project:
+ additionalProperties: false
+ description: Details about a project.
+ properties:
+ archived:
+ description: Whether the project is archived.
+ readOnly: true
+ type: boolean
+ archivedBy:
+ allOf:
+ - $ref: "#/components/schemas/User"
+ description: The user who archived the project.
+ readOnly: true
+ archivedDate:
+ description: The date when the project was archived.
+ format: date-time
+ readOnly: true
+ type: string
+ assigneeType:
+ description: The default assignee when creating issues for this project.
+ enum:
+ - PROJECT_LEAD
+ - UNASSIGNED
+ readOnly: true
+ type: string
+ avatarUrls:
+ allOf:
+ - $ref: "#/components/schemas/AvatarUrlsBean"
+ description: The URLs of the project's avatars.
+ readOnly: true
+ components:
+ description: List of the components contained in the project.
+ items:
+ $ref: "#/components/schemas/Component"
+ readOnly: true
+ type: array
+ deleted:
+ description: Whether the project is marked as deleted.
+ readOnly: true
+ type: boolean
+ deletedBy:
+ allOf:
+ - $ref: "#/components/schemas/User"
+ description: The user who marked the project as deleted.
+ readOnly: true
+ deletedDate:
+ description: The date when the project was marked as deleted.
+ format: date-time
+ readOnly: true
+ type: string
+ description:
+ description: A brief description of the project.
+ readOnly: true
+ type: string
+ email:
+ description: An email address associated with the project.
+ type: string
+ expand:
+ description: Expand options that include additional project details in the
+ response.
+ readOnly: true
+ type: string
+ xml:
+ attribute: true
+ favourite:
+ description: Whether the project is selected as a favorite.
+ type: boolean
+ id:
+ description: The ID of the project.
+ type: string
+ insight:
+ allOf:
+ - $ref: "#/components/schemas/ProjectInsight"
+ description: Insights about the project.
+ readOnly: true
+ isPrivate:
+ description: Whether the project is private.
+ readOnly: true
+ type: boolean
+ issueTypeHierarchy:
+ allOf:
+ - $ref: "#/components/schemas/Hierarchy"
+ description: The issue type hierarchy for the project.
+ readOnly: true
+ issueTypes:
+ description: List of the issue types available in the project.
+ items:
+ $ref: "#/components/schemas/IssueTypeDetails"
+ readOnly: true
+ type: array
+ key:
+ description: The key of the project.
+ readOnly: true
+ type: string
+ lead:
+ allOf:
+ - $ref: "#/components/schemas/User"
+ description: The username of the project lead.
+ readOnly: true
+ name:
+ description: The name of the project.
+ readOnly: true
+ type: string
+ permissions:
+ allOf:
+ - $ref: "#/components/schemas/ProjectPermissions"
+ description: User permissions on the project
+ readOnly: true
+ projectCategory:
+ allOf:
+ - $ref: "#/components/schemas/ProjectCategory"
+ description: The category the project belongs to.
+ readOnly: true
+ projectTypeKey:
+ description: The [project
+ type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes)
+ of the project.
+ enum:
+ - software
+ - service_desk
+ - business
+ readOnly: true
+ type: string
+ properties:
+ additionalProperties:
+ readOnly: true
+ description: Map of project properties
+ readOnly: true
+ type: object
+ retentionTillDate:
+ description: The date when the project is deleted permanently.
+ format: date-time
+ readOnly: true
+ type: string
+ roles:
+ additionalProperties:
+ format: uri
+ readOnly: true
+ type: string
+ description: The name and self URL for each role defined in the project. For
+ more information, see [Create project
+ role](#api-rest-api-3-role-post).
+ readOnly: true
+ type: object
+ self:
+ description: The URL of the project details.
+ format: uri
+ readOnly: true
+ type: string
+ simplified:
+ description: Whether the project is simplified.
+ readOnly: true
+ type: boolean
+ style:
+ description: The type of the project.
+ enum:
+ - classic
+ - next-gen
+ readOnly: true
+ type: string
+ url:
+ description: A link to information about this project, such as project
+ documentation.
+ readOnly: true
+ type: string
+ uuid:
+ description: Unique ID for next-gen projects.
+ format: uuid
+ readOnly: true
+ type: string
+ versions:
+ description: The versions defined in the project. For more information, see
+ [Create version](#api-rest-api-3-version-post).
+ items:
+ $ref: "#/components/schemas/Version"
+ readOnly: true
+ type: array
+ type: object
+ xml:
+ name: project
+ ProjectAvatars:
+ additionalProperties: false
+ description: List of project avatars.
+ properties:
+ custom:
+ description: List of avatars added to Jira. These avatars may be deleted.
+ items:
+ $ref: "#/components/schemas/Avatar"
+ readOnly: true
+ type: array
+ system:
+ description: List of avatars included with Jira. These avatars cannot be deleted.
+ items:
+ $ref: "#/components/schemas/Avatar"
+ readOnly: true
+ type: array
+ type: object
+ ProjectCategory:
+ additionalProperties: false
+ description: A project category.
+ properties:
+ description:
+ description: The description of the project category.
+ type: string
+ id:
+ description: The ID of the project category.
+ readOnly: true
+ type: string
+ name:
+ description: The name of the project category. Required on create, optional on
+ update.
+ type: string
+ self:
+ description: The URL of the project category.
+ format: uri
+ readOnly: true
+ type: string
+ type: object
+ ProjectEmailAddress:
+ additionalProperties: false
+ description: A project's sender email address.
+ properties:
+ emailAddress:
+ description: The email address.
+ type: string
+ type: object
+ ProjectFeature:
+ additionalProperties: false
+ description: Project feature.
+ properties:
+ feature:
+ description: Feature's key.
+ type: string
+ featureCategory:
+ description: Feature's category.
+ type: string
+ imageUri:
+ description: Uri to the image that should be used to display this feature.
+ type: string
+ localisedDescription:
+ description: Description to display for this feature, localised.
+ type: string
+ localisedName:
+ description: Name to display for this feature, localised.
+ type: string
+ prerequisites:
+ description: List of the keys of features required as prerequisites to enable
+ this feature.
+ items:
+ type: string
+ type: array
+ projectId:
+ description: Project ID.
+ format: int64
+ type: integer
+ state:
+ description: State of the feature.
+ enum:
+ - ENABLED
+ - DISABLED
+ - COMING_SOON
+ type: string
+ toggleLocked:
+ description: Determines whether a feature can be toggled or not.
+ type: boolean
+ type: object
+ ProjectFeatureToggleRequest:
+ additionalProperties: false
+ description: Container for a request to toggle the state of the feature to
+ ENABLED or DISABLED.
+ properties:
+ state:
+ description: The new state for the feature
+ enum:
+ - ENABLED
+ - DISABLED
+ - COMING_SOON
+ type: string
+ type: object
+ ProjectFeaturesResponse:
+ additionalProperties: false
+ description: Container for the list of features on the project.
+ properties:
+ features:
+ description: The list of features on the project.
+ items:
+ $ref: "#/components/schemas/ProjectFeature"
+ type: array
+ type: object
+ ProjectForScope:
+ additionalProperties: false
+ description: Details about a next-gen project.
+ properties:
+ avatarUrls:
+ allOf:
+ - $ref: "#/components/schemas/AvatarUrlsBean"
+ description: The URLs of the project's avatars.
+ readOnly: true
+ id:
+ description: The ID of the project.
+ type: string
+ key:
+ description: The key of the project.
+ readOnly: true
+ type: string
+ name:
+ description: The name of the project.
+ readOnly: true
+ type: string
+ projectCategory:
+ allOf:
+ - $ref: "#/components/schemas/UpdatedProjectCategory"
+ description: The category the project belongs to.
+ readOnly: true
+ projectTypeKey:
+ description: The [project
+ type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes)
+ of the project.
+ enum:
+ - software
+ - service_desk
+ - business
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the project details.
+ readOnly: true
+ type: string
+ simplified:
+ description: Whether or not the project is simplified.
+ readOnly: true
+ type: boolean
+ type: object
+ ProjectIdentifierBean:
+ additionalProperties: false
+ description: The identifiers for a project.
+ properties:
+ id:
+ description: The ID of the project.
+ format: int64
+ readOnly: true
+ type: integer
+ key:
+ description: The key of the project.
+ readOnly: true
+ type: string
+ type: object
+ ProjectIdentifiers:
+ additionalProperties: false
+ description: Identifiers for a project.
+ properties:
+ id:
+ description: The ID of the created project.
+ format: int64
+ readOnly: true
+ type: integer
+ key:
+ description: The key of the created project.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the created project.
+ format: uri
+ readOnly: true
+ type: string
+ required:
+ - id
+ - key
+ - self
+ type: object
+ ProjectIds:
+ additionalProperties: false
+ description: A list of project IDs.
+ properties:
+ projectIds:
+ description: The IDs of projects.
+ items:
+ type: string
+ writeOnly: true
+ type: array
+ writeOnly: true
+ required:
+ - projectIds
+ type: object
+ ProjectInputBean:
+ additionalProperties: false
+ properties:
+ assigneeType:
+ description: The default assignee when creating issues for this project.
+ enum:
+ - PROJECT_LEAD
+ - UNASSIGNED
+ type: string
+ avatarId:
+ description: An integer value for the project's avatar.
+ format: int64
+ type: integer
+ categoryId:
+ description: The ID of the project's category. A complete list of category IDs
+ is found using the [Get all project
+ categories](#api-rest-api-3-projectCategory-get) operation.
+ format: int64
+ type: integer
+ description:
+ description: A brief description of the project.
+ type: string
+ issueSecurityScheme:
+ description: The ID of the issue security scheme for the project, which enables
+ you to control who can and cannot view issues. Use the [Get issue
+ security schemes](#api-rest-api-3-issuesecurityschemes-get) resource
+ to get all issue security scheme IDs.
+ format: int64
+ type: integer
+ key:
+ description: Project keys must be unique and start with an uppercase letter
+ followed by one or more uppercase alphanumeric characters. The
+ maximum length is 10 characters. Required when creating a project.
+ Optional when updating a project.
+ type: string
+ lead:
+ description: This parameter is deprecated because of privacy changes. Use
+ `leadAccountId` instead. See the [migration
+ guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details. The user name of the project lead. Either `lead` or
+ `leadAccountId` must be set when creating a project. Optional when
+ updating a project. Cannot be provided with `leadAccountId`.
+ type: string
+ leadAccountId:
+ description: The account ID of the project lead. Either `lead` or
+ `leadAccountId` must be set when creating a project. Optional when
+ updating a project. Cannot be provided with `lead`.
+ maxLength: 128
+ type: string
+ name:
+ description: The name of the project. Required when creating a project. Optional
+ when updating a project.
+ type: string
+ notificationScheme:
+ description: The ID of the notification scheme for the project. Use the [Get
+ notification schemes](#api-rest-api-3-notificationscheme-get)
+ resource to get a list of notification scheme IDs.
+ format: int64
+ type: integer
+ permissionScheme:
+ description: The ID of the permission scheme for the project. Use the [Get all
+ permission schemes](#api-rest-api-3-permissionscheme-get) resource
+ to see a list of all permission scheme IDs.
+ format: int64
+ type: integer
+ projectTemplateKey:
+ description: A prebuilt configuration for a project. The type of the
+ `projectTemplateKey` must match with the type of the
+ `projectTypeKey`. Required when creating a project. Not applicable
+ for the Update project resource.
+ enum:
+ - com.pyxis.greenhopper.jira:gh-simplified-agility-kanban
+ - com.pyxis.greenhopper.jira:gh-simplified-agility-scrum
+ - com.pyxis.greenhopper.jira:gh-simplified-basic
+ - com.pyxis.greenhopper.jira:gh-simplified-kanban-classic
+ - com.pyxis.greenhopper.jira:gh-simplified-scrum-classic
+ - com.atlassian.servicedesk:simplified-it-service-desk
+ - com.atlassian.servicedesk:simplified-internal-service-desk
+ - com.atlassian.servicedesk:simplified-external-service-desk
+ - com.atlassian.servicedesk:simplified-hr-service-desk
+ - com.atlassian.servicedesk:simplified-facilities-service-desk
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-content-management
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-document-approval
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-lead-tracking
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-process-control
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-procurement
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-project-management
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-recruitment
+ - com.atlassian.jira-core-project-templates:jira-core-simplified-task-
+ type: string
+ projectTypeKey:
+ description: The [project
+ type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes),
+ which dictates the application-specific feature set. Required when
+ creating a project. Not applicable for the Update project resource.
+ enum:
+ - software
+ - service_desk
+ - business
+ type: string
+ url:
+ description: A link to information about this project, such as project
+ documentation
+ type: string
+ type: object
+ ProjectInsight:
+ additionalProperties: false
+ description: Additional details about a project.
+ properties:
+ lastIssueUpdateTime:
+ description: The last issue update time.
+ format: date-time
+ readOnly: true
+ type: string
+ totalIssueCount:
+ description: Total issue count.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ ProjectIssueCreateMetadata:
+ additionalProperties: false
+ description: Details of the issue creation metadata for a project.
+ properties:
+ avatarUrls:
+ allOf:
+ - $ref: "#/components/schemas/AvatarUrlsBean"
+ description: List of the project's avatars, returning the avatar size and
+ associated URL.
+ readOnly: true
+ expand:
+ description: Expand options that include additional project issue create
+ metadata details in the response.
+ readOnly: true
+ type: string
+ xml:
+ attribute: true
+ id:
+ description: The ID of the project.
+ readOnly: true
+ type: string
+ issuetypes:
+ description: List of the issue types supported by the project.
+ items:
+ $ref: "#/components/schemas/IssueTypeIssueCreateMetadata"
+ readOnly: true
+ type: array
+ key:
+ description: The key of the project.
+ readOnly: true
+ type: string
+ name:
+ description: The name of the project.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the project.
+ readOnly: true
+ type: string
+ type: object
+ ProjectIssueSecurityLevels:
+ additionalProperties: false
+ description: List of issue level security items in a project.
+ properties:
+ levels:
+ description: Issue level security items list.
+ items:
+ $ref: "#/components/schemas/SecurityLevel"
+ readOnly: true
+ type: array
+ required:
+ - levels
+ type: object
+ ProjectIssueTypeHierarchy:
+ additionalProperties: false
+ description: The hierarchy of issue types within a project.
+ properties:
+ hierarchy:
+ description: Details of an issue type hierarchy level.
+ items:
+ $ref: "#/components/schemas/ProjectIssueTypesHierarchyLevel"
+ readOnly: true
+ type: array
+ projectId:
+ description: The ID of the project.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ ProjectIssueTypeMapping:
+ additionalProperties: false
+ description: The project and issue type mapping.
+ properties:
+ issueTypeId:
+ description: The ID of the issue type.
+ type: string
+ writeOnly: true
+ projectId:
+ description: The ID of the project.
+ type: string
+ writeOnly: true
+ required:
+ - issueTypeId
+ - projectId
+ type: object
+ writeOnly: true
+ ProjectIssueTypeMappings:
+ additionalProperties: false
+ description: The project and issue type mappings.
+ properties:
+ mappings:
+ description: The project and issue type mappings.
+ items:
+ $ref: "#/components/schemas/ProjectIssueTypeMapping"
+ type: array
+ writeOnly: true
+ required:
+ - mappings
+ type: object
+ ProjectIssueTypesHierarchyLevel:
+ additionalProperties: false
+ description: Details of an issue type hierarchy level.
+ properties:
+ entityId:
+ description: "The ID of the issue type hierarchy level. This property is
+ deprecated, see [Change notice: Removing hierarchy level IDs from
+ next-gen
+ APIs](https://developer.atlassian.com/cloud/jira/platform/change-no\
+ tice-removing-hierarchy-level-ids-from-next-gen-apis/)."
+ format: uuid
+ readOnly: true
+ type: string
+ issueTypes:
+ description: The list of issue types in the hierarchy level.
+ items:
+ $ref: "#/components/schemas/IssueTypeInfo"
+ readOnly: true
+ type: array
+ level:
+ description: The level of the issue type hierarchy level.
+ format: int32
+ readOnly: true
+ type: integer
+ name:
+ description: The name of the issue type hierarchy level.
+ readOnly: true
+ type: string
+ type: object
+ ProjectPermissions:
+ additionalProperties: false
+ description: Permissions which a user has on a project.
+ properties:
+ canEdit:
+ description: Whether the logged user can edit the project.
+ readOnly: true
+ type: boolean
+ type: object
+ ProjectRole:
+ additionalProperties: false
+ description: Details about the roles in a project.
+ properties:
+ actors:
+ description: The list of users who act in this role.
+ items:
+ $ref: "#/components/schemas/RoleActor"
+ readOnly: true
+ type: array
+ admin:
+ description: Whether this role is the admin role for the project.
+ readOnly: true
+ type: boolean
+ currentUserRole:
+ description: Whether the calling user is part of this role.
+ type: boolean
+ default:
+ description: Whether this role is the default role for the project
+ readOnly: true
+ type: boolean
+ description:
+ description: The description of the project role.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the project role.
+ format: int64
+ readOnly: true
+ type: integer
+ name:
+ description: The name of the project role.
+ type: string
+ roleConfigurable:
+ description: Whether the roles are configurable for this project.
+ readOnly: true
+ type: boolean
+ scope:
+ allOf:
+ - $ref: "#/components/schemas/Scope"
+ description: The scope of the role. Indicated for roles associated with
+ [next-gen projects](https://confluence.atlassian.com/x/loMyO).
+ readOnly: true
+ self:
+ description: The URL the project role details.
+ format: uri
+ readOnly: true
+ type: string
+ translatedName:
+ description: The translated name of the project role.
+ type: string
+ type: object
+ ProjectRoleActorsUpdateBean:
+ additionalProperties: false
+ properties:
+ categorisedActors:
+ additionalProperties:
+ items:
+ type: string
+ type: array
+ description: The actors to add to the project role. Add groups using
+ `atlassian-group-role-actor` and a list of group names. For example,
+ `"atlassian-group-role-actor":["another","administrators"]}`. Add
+ users using `atlassian-user-role-actor` and a list of account IDs.
+ For example,
+ `"atlassian-user-role-actor":["12345678-9abc-def1-2345-6789abcdef12",
+ "abcdef12-3456-789a-bcde-f123456789ab"]`.
+ type: object
+ id:
+ description: The ID of the project role. Use [Get all project
+ roles](#api-rest-api-3-role-get) to get a list of project role IDs.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ xml:
+ name: actor
+ ProjectRoleDetails:
+ additionalProperties: false
+ description: Details about a project role.
+ properties:
+ admin:
+ description: Whether this role is the admin role for the project.
+ readOnly: true
+ type: boolean
+ default:
+ description: Whether this role is the default role for the project.
+ readOnly: true
+ type: boolean
+ description:
+ description: The description of the project role.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the project role.
+ format: int64
+ readOnly: true
+ type: integer
+ name:
+ description: The name of the project role.
+ type: string
+ roleConfigurable:
+ description: Whether the roles are configurable for this project.
+ readOnly: true
+ type: boolean
+ scope:
+ allOf:
+ - $ref: "#/components/schemas/Scope"
+ description: The scope of the role. Indicated for roles associated with
+ [next-gen projects](https://confluence.atlassian.com/x/loMyO).
+ readOnly: true
+ self:
+ description: The URL the project role details.
+ format: uri
+ readOnly: true
+ type: string
+ translatedName:
+ description: The translated name of the project role.
+ type: string
+ type: object
+ ProjectRoleGroup:
+ additionalProperties: false
+ description: Details of the group associated with the role.
+ properties:
+ displayName:
+ description: The display name of the group.
+ type: string
+ name:
+ description: The name of the group
+ type: string
+ type: object
+ ProjectRoleUser:
+ additionalProperties: false
+ description: Details of the user associated with the role.
+ properties:
+ accountId:
+ description: The account ID of the user, which uniquely identifies the user
+ across all Atlassian products. For example,
+ *5b10ac8d82e05b22cc7d4ef5*. Returns *unknown* if the record is
+ deleted and corrupted, for example, as the result of a server
+ import.
+ maxLength: 128
+ readOnly: true
+ type: string
+ type: object
+ ProjectScopeBean:
+ additionalProperties: false
+ properties:
+ attributes:
+ description: Defines the behavior of the option in the project.If notSelectable
+ is set, the option cannot be set as the field's value. This is
+ useful for archiving an option that has previously been selected but
+ shouldn't be used anymore.If defaultValue is set, the option is
+ selected by default.
+ items:
+ enum:
+ - notSelectable
+ - defaultValue
+ type: string
+ type: array
+ uniqueItems: true
+ id:
+ description: The ID of the project that the option's behavior applies to.
+ format: int64
+ type: integer
+ type: object
+ ProjectType:
+ additionalProperties: false
+ description: Details about a project type.
+ properties:
+ color:
+ description: The color of the project type.
+ readOnly: true
+ type: string
+ descriptionI18nKey:
+ description: The key of the project type's description.
+ readOnly: true
+ type: string
+ formattedKey:
+ description: The formatted key of the project type.
+ readOnly: true
+ type: string
+ icon:
+ description: The icon of the project type.
+ readOnly: true
+ type: string
+ key:
+ description: The key of the project type.
+ readOnly: true
+ type: string
+ type: object
+ PropertyKey:
+ additionalProperties: false
+ description: Property key details.
+ properties:
+ key:
+ description: The key of the property.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the property.
+ readOnly: true
+ type: string
+ type: object
+ PropertyKeys:
+ additionalProperties: false
+ description: List of property keys.
+ properties:
+ keys:
+ description: Property key details.
+ items:
+ $ref: "#/components/schemas/PropertyKey"
+ readOnly: true
+ type: array
+ type: object
+ PublishedWorkflowId:
+ additionalProperties: false
+ description: Properties that identify a published workflow.
+ properties:
+ entityId:
+ description: The entity ID of the workflow.
+ type: string
+ name:
+ description: The name of the workflow.
+ type: string
+ required:
+ - name
+ type: object
+ RegisteredWebhook:
+ additionalProperties: false
+ description: ID of a registered webhook or error messages explaining why a
+ webhook wasn't registered.
+ properties:
+ createdWebhookId:
+ description: The ID of the webhook. Returned if the webhook is created.
+ format: int64
+ type: integer
+ errors:
+ description: Error messages specifying why the webhook creation failed.
+ items:
+ description: Error messages specifying why the webhook creation failed.
+ type: string
+ type: array
+ type: object
+ RemoteIssueLink:
+ additionalProperties: false
+ description: Details of an issue remote link.
+ properties:
+ application:
+ allOf:
+ - $ref: "#/components/schemas/Application"
+ description: Details of the remote application the linked item is in.
+ globalId:
+ description: The global ID of the link, such as the ID of the item on the remote
+ system.
+ type: string
+ id:
+ description: The ID of the link.
+ format: int64
+ type: integer
+ object:
+ allOf:
+ - $ref: "#/components/schemas/RemoteObject"
+ description: Details of the item linked to.
+ relationship:
+ description: Description of the relationship between the issue and the linked
+ item.
+ type: string
+ self:
+ description: The URL of the link.
+ format: uri
+ type: string
+ type: object
+ RemoteIssueLinkIdentifies:
+ additionalProperties: false
+ description: Details of the identifiers for a created or updated remote issue link.
+ properties:
+ id:
+ description: The ID of the remote issue link, such as the ID of the item on the
+ remote system.
+ format: int64
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ self:
+ description: The URL of the remote issue link.
+ readOnly: true
+ type: string
+ xml:
+ attribute: true
+ type: object
+ RemoteIssueLinkRequest:
+ additionalProperties: true
+ description: Details of a remote issue link.
+ properties:
+ application:
+ allOf:
+ - $ref: "#/components/schemas/Application"
+ description: Details of the remote application the linked item is in. For
+ example, trello.
+ globalId:
+ description: >-
+ An identifier for the remote item in the remote system. For
+ example, the global ID for a remote item in Confluence would consist
+ of the app ID and page ID, like this: `appId=456&pageId=123`.
+
+
+ Setting this field enables the remote issue link details to be updated or deleted using remote system and item details as the record identifier, rather than using the record's Jira ID.
+
+
+ The maximum length is 255 characters.
+ type: string
+ object:
+ allOf:
+ - $ref: "#/components/schemas/RemoteObject"
+ description: Details of the item linked to.
+ relationship:
+ description: Description of the relationship between the issue and the linked
+ item. If not set, the relationship description "links to" is used in
+ Jira.
+ type: string
+ required:
+ - object
+ type: object
+ RemoteObject:
+ additionalProperties: true
+ description: The linked item.
+ properties:
+ icon:
+ allOf:
+ - $ref: "#/components/schemas/Icon"
+ description: Details of the icon for the item. If no icon is defined, the
+ default link icon is used in Jira.
+ status:
+ allOf:
+ - $ref: "#/components/schemas/Status"
+ description: The status of the item.
+ summary:
+ description: The summary details of the item.
+ type: string
+ title:
+ description: The title of the item.
+ type: string
+ url:
+ description: The URL of the item.
+ type: string
+ required:
+ - title
+ - url
+ type: object
+ RemoveOptionFromIssuesResult:
+ additionalProperties: false
+ properties:
+ errors:
+ allOf:
+ - $ref: "#/components/schemas/SimpleErrorCollection"
+ description: A collection of errors related to unchanged issues. The collection
+ size is limited, which means not all errors may be returned.
+ modifiedIssues:
+ description: The IDs of the modified issues.
+ items:
+ format: int64
+ type: integer
+ type: array
+ unmodifiedIssues:
+ description: The IDs of the unchanged issues, those issues where errors prevent
+ modification.
+ items:
+ format: int64
+ type: integer
+ type: array
+ type: object
+ RenamedCascadingOption:
+ additionalProperties: false
+ description: Details of a custom field cascading option to rename.
+ properties:
+ newValue:
+ description: The new value of the cascading option.
+ maxLength: 255
+ type: string
+ value:
+ description: The value of the cascading option.
+ type: string
+ required:
+ - newValue
+ - value
+ type: object
+ writeOnly: true
+ RenamedOption:
+ additionalProperties: false
+ description: Details of a custom field option to rename.
+ properties:
+ cascadingOptions:
+ description: The new values for the cascading options of this option. Only used
+ for Select List (cascading) fields.
+ items:
+ $ref: "#/components/schemas/RenamedCascadingOption"
+ type: array
+ newValue:
+ description: The new value of the option.
+ maxLength: 255
+ type: string
+ value:
+ description: The current option value.
+ type: string
+ required:
+ - newValue
+ - value
+ type: object
+ writeOnly: true
+ Resolution:
+ additionalProperties: false
+ description: Details of an issue resolution.
+ properties:
+ description:
+ description: The description of the issue resolution.
+ type: string
+ id:
+ description: The ID of the issue resolution.
+ type: string
+ name:
+ description: The name of the issue resolution.
+ type: string
+ self:
+ description: The URL of the issue resolution.
+ format: uri
+ type: string
+ type: object
+ xml:
+ name: resolution
+ RestrictedPermission:
+ additionalProperties: true
+ description: Details of the permission.
+ properties:
+ id:
+ description: The ID of the permission. Either `id` or `key` must be specified.
+ Use [Get all permissions](#api-rest-api-3-permissions-get) to get
+ the list of permissions.
+ type: string
+ key:
+ description: The key of the permission. Either `id` or `key` must be specified.
+ Use [Get all permissions](#api-rest-api-3-permissions-get) to get
+ the list of permissions.
+ type: string
+ type: object
+ RichText:
+ properties:
+ emptyAdf:
+ type: boolean
+ finalised:
+ type: boolean
+ valueSet:
+ type: boolean
+ type: object
+ RoleActor:
+ additionalProperties: false
+ description: Details about a user assigned to a project role.
+ properties:
+ actorGroup:
+ allOf:
+ - $ref: "#/components/schemas/ProjectRoleGroup"
+ readOnly: true
+ actorUser:
+ allOf:
+ - $ref: "#/components/schemas/ProjectRoleUser"
+ readOnly: true
+ avatarUrl:
+ description: The avatar of the role actor.
+ format: uri
+ readOnly: true
+ type: string
+ displayName:
+ description: The display name of the role actor. For users, depending on the
+ user’s privacy setting, this may return an alternative value for the
+ user's name.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the role actor.
+ format: int64
+ readOnly: true
+ type: integer
+ name:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ readOnly: true
+ type: string
+ type:
+ description: The type of role actor.
+ enum:
+ - atlassian-group-role-actor
+ - atlassian-user-role-actor
+ readOnly: true
+ type: string
+ type: object
+ xml:
+ name: projectRoleActor
+ RuleConfiguration:
+ additionalProperties: false
+ description: A rule configuration.
+ properties:
+ value:
+ description: Configuration of the rule, as it is stored by the Connect app on
+ the rule configuration page.
+ type: string
+ required:
+ - value
+ type: object
+ Scope:
+ additionalProperties: true
+ description: The projects the item is associated with. Indicated for items
+ associated with [next-gen
+ projects](https://confluence.atlassian.com/x/loMyO).
+ properties:
+ project:
+ allOf:
+ - $ref: "#/components/schemas/ProjectForScope"
+ description: The project the item has scope in.
+ readOnly: true
+ type:
+ description: The type of scope.
+ enum:
+ - PROJECT
+ - TEMPLATE
+ readOnly: true
+ type: string
+ type: object
+ Screen:
+ additionalProperties: false
+ description: A screen.
+ properties:
+ description:
+ description: The description of the screen.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the screen.
+ format: int64
+ readOnly: true
+ type: integer
+ name:
+ description: The name of the screen.
+ readOnly: true
+ type: string
+ scope:
+ allOf:
+ - $ref: "#/components/schemas/Scope"
+ description: The scope of the screen.
+ type: object
+ ScreenDetails:
+ additionalProperties: false
+ description: Details of a screen.
+ properties:
+ description:
+ description: The description of the screen. The maximum length is 255 characters.
+ type: string
+ writeOnly: true
+ name:
+ description: The name of the screen. The name must be unique. The maximum length
+ is 255 characters.
+ type: string
+ writeOnly: true
+ required:
+ - name
+ type: object
+ ScreenID:
+ additionalProperties: false
+ description: ID of a screen.
+ properties:
+ id:
+ description: The ID of the screen.
+ type: string
+ required:
+ - id
+ type: object
+ ScreenScheme:
+ additionalProperties: false
+ description: A screen scheme.
+ properties:
+ description:
+ description: The description of the screen scheme.
+ type: string
+ id:
+ description: The ID of the screen scheme.
+ format: int64
+ type: integer
+ issueTypeScreenSchemes:
+ allOf:
+ - $ref: "#/components/schemas/PageBeanIssueTypeScreenScheme"
+ description: Details of the issue type screen schemes associated with the screen
+ scheme.
+ name:
+ description: The name of the screen scheme.
+ type: string
+ screens:
+ allOf:
+ - $ref: "#/components/schemas/ScreenTypes"
+ description: The IDs of the screens for the screen types of the screen scheme.
+ type: object
+ ScreenSchemeDetails:
+ additionalProperties: false
+ description: Details of a screen scheme.
+ properties:
+ description:
+ description: The description of the screen scheme. The maximum length is 255
+ characters.
+ type: string
+ writeOnly: true
+ name:
+ description: The name of the screen scheme. The name must be unique. The maximum
+ length is 255 characters.
+ type: string
+ writeOnly: true
+ screens:
+ allOf:
+ - $ref: "#/components/schemas/ScreenTypes"
+ description: The IDs of the screens for the screen types of the screen scheme.
+ Only screens used in classic projects are accepted.
+ required:
+ - name
+ - screens
+ type: object
+ ScreenSchemeId:
+ additionalProperties: false
+ description: The ID of a screen scheme.
+ properties:
+ id:
+ description: The ID of the screen scheme.
+ format: int64
+ readOnly: true
+ type: integer
+ required:
+ - id
+ type: object
+ ScreenTypes:
+ additionalProperties: false
+ description: The IDs of the screens for the screen types of the screen scheme.
+ properties:
+ create:
+ description: The ID of the create screen.
+ format: int64
+ type: integer
+ default:
+ description: The ID of the default screen. Required when creating a screen scheme.
+ format: int64
+ type: integer
+ edit:
+ description: The ID of the edit screen.
+ format: int64
+ type: integer
+ view:
+ description: The ID of the view screen.
+ format: int64
+ type: integer
+ required:
+ - defaultScreen
+ type: object
+ writeOnly: true
+ ScreenWithTab:
+ additionalProperties: false
+ description: A screen with tab details.
+ properties:
+ description:
+ description: The description of the screen.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the screen.
+ format: int64
+ readOnly: true
+ type: integer
+ name:
+ description: The name of the screen.
+ readOnly: true
+ type: string
+ scope:
+ allOf:
+ - $ref: "#/components/schemas/Scope"
+ description: The scope of the screen.
+ tab:
+ allOf:
+ - $ref: "#/components/schemas/ScreenableTab"
+ description: The tab for the screen
+ type: object
+ ScreenableField:
+ additionalProperties: false
+ description: A screen tab field.
+ properties:
+ id:
+ description: The ID of the screen tab field.
+ readOnly: true
+ type: string
+ name:
+ description: The name of the screen tab field. Required on create and update.
+ The maximum length is 255 characters.
+ type: string
+ type: object
+ ScreenableTab:
+ additionalProperties: false
+ description: A screen tab.
+ properties:
+ id:
+ description: The ID of the screen tab.
+ format: int64
+ readOnly: true
+ type: integer
+ name:
+ description: The name of the screen tab. The maximum length is 255 characters.
+ type: string
+ required:
+ - name
+ type: object
+ SearchAutoCompleteFilter:
+ additionalProperties: false
+ description: Details of how to filter and list search auto complete information.
+ properties:
+ includeCollapsedFields:
+ default: false
+ description: Include collapsed fields for fields that have non-unique names.
+ type: boolean
+ projectIds:
+ description: List of project IDs used to filter the visible field details
+ returned.
+ items:
+ format: int64
+ type: integer
+ type: array
+ type: object
+ SearchRequestBean:
+ additionalProperties: false
+ properties:
+ expand:
+ description: >-
+ Use [expand](em>#expansion) to include additional information about
+ issues in the response. Note that, unlike the majority of instances
+ where `expand` is specified, `expand` is defined as a list of
+ values. The expand options are:
+
+ * `renderedFields` Returns field values rendered in HTML format.
+ * `names` Returns the display name of each field.
+ * `schema` Returns the schema describing a field type.
+ * `transitions` Returns all possible transitions for the issue.
+ * `operations` Returns all possible operations for the issue.
+ * `editmeta` Returns information about how each field can be edited.
+ * `changelog` Returns a list of recent updates to an issue, sorted by date, starting from the most recent.
+ * `versionedRepresentations` Instead of `fields`, returns `versionedRepresentations` a JSON array containing each version of a field's value, with the highest numbered item representing the most recent version.
+ items:
+ type: string
+ type: array
+ fields:
+ description: >-
+ A list of fields to return for each issue, use it to retrieve a
+ subset of fields. This parameter accepts a comma-separated list.
+ Expand options include:
+
+ * `*all` Returns all fields.
+ * `*navigable` Returns navigable fields.
+ * Any issue field, prefixed with a minus to exclude.
+
+ The default is `*navigable`.
+
+
+ Examples:
+
+ * `summary,comment` Returns the summary and comments fields only.
+ * `-description` Returns all navigable (default) fields except description.
+ * `*all,-comment` Returns all fields except comments.
+
+ Multiple `fields` parameters can be included in a request.
+
+
+ Note: All navigable fields are returned by default. This differs from [GET issue](#api-rest-api-3-issue-issueIdOrKey-get) where the default is all fields.
+ items:
+ type: string
+ type: array
+ fieldsByKeys:
+ description: Reference fields by their key (rather than ID). The default is
+ `false`.
+ type: boolean
+ jql:
+ description: A [JQL](https://confluence.atlassian.com/x/egORLQ) expression.
+ type: string
+ maxResults:
+ default: 50
+ description: The maximum number of items to return per page.
+ format: int32
+ type: integer
+ properties:
+ description: A list of up to 5 issue properties to include in the results. This
+ parameter accepts a comma-separated list.
+ items:
+ type: string
+ type: array
+ startAt:
+ description: The index of the first item to return in the page of results (page
+ offset). The base index is `0`.
+ format: int32
+ type: integer
+ validateQuery:
+ description: >-
+ Determines how to validate the JQL query and treat the validation
+ results. Supported values:
+
+ * `strict` Returns a 400 response code if any errors are found, along with a list of all errors (and warnings).
+ * `warn` Returns all errors as warnings.
+ * `none` No validation is performed.
+ * `true` *Deprecated* A legacy synonym for `strict`.
+ * `false` *Deprecated* A legacy synonym for `warn`.
+
+ The default is `strict`.
+
+
+ Note: If the JQL is not correctly formed a 400 response code is returned, regardless of the `validateQuery` value.
+ enum:
+ - strict
+ - warn
+ - none
+ - "true"
+ - "false"
+ type: string
+ type: object
+ SearchResults:
+ additionalProperties: false
+ description: The result of a JQL search.
+ properties:
+ expand:
+ description: Expand options that include additional search result details in the
+ response.
+ readOnly: true
+ type: string
+ issues:
+ description: The list of issues found by the search.
+ items:
+ $ref: "#/components/schemas/IssueBean"
+ readOnly: true
+ type: array
+ maxResults:
+ description: The maximum number of results that could be on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ names:
+ additionalProperties:
+ readOnly: true
+ type: string
+ description: The ID and name of each field in the search results.
+ readOnly: true
+ type: object
+ schema:
+ additionalProperties:
+ $ref: "#/components/schemas/JsonTypeBean"
+ description: The schema describing the field types in the search results.
+ readOnly: true
+ type: object
+ startAt:
+ description: The index of the first item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ total:
+ description: The number of results on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ warningMessages:
+ description: Any warnings related to the JQL query.
+ items:
+ readOnly: true
+ type: string
+ readOnly: true
+ type: array
+ type: object
+ SecurityLevel:
+ additionalProperties: false
+ description: Details of an issue level security item.
+ properties:
+ description:
+ description: The description of the issue level security item.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the issue level security item.
+ readOnly: true
+ type: string
+ name:
+ description: The name of the issue level security item.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the issue level security item.
+ readOnly: true
+ type: string
+ type: object
+ SecurityScheme:
+ additionalProperties: false
+ description: Details about a security scheme.
+ properties:
+ defaultSecurityLevelId:
+ description: The ID of the default security level.
+ format: int64
+ readOnly: true
+ type: integer
+ description:
+ description: The description of the issue security scheme.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the issue security scheme.
+ format: int64
+ readOnly: true
+ type: integer
+ levels:
+ items:
+ $ref: "#/components/schemas/SecurityLevel"
+ type: array
+ name:
+ description: The name of the issue security scheme.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the issue security scheme.
+ readOnly: true
+ type: string
+ type: object
+ SecuritySchemes:
+ additionalProperties: false
+ description: List of security schemes.
+ properties:
+ issueSecuritySchemes:
+ description: List of security schemes.
+ items:
+ $ref: "#/components/schemas/SecurityScheme"
+ readOnly: true
+ type: array
+ type: object
+ ServerInformation:
+ additionalProperties: false
+ description: Details about the Jira instance.
+ properties:
+ baseUrl:
+ description: The base URL of the Jira instance.
+ type: string
+ buildDate:
+ description: The timestamp when the Jira version was built.
+ format: date-time
+ type: string
+ buildNumber:
+ description: The build number of the Jira version.
+ format: int32
+ type: integer
+ deploymentType:
+ description: The type of server deployment. This is always returned as *Cloud*.
+ type: string
+ healthChecks:
+ description: Jira instance health check results. Deprecated and no longer
+ returned.
+ items:
+ $ref: "#/components/schemas/HealthCheckResult"
+ type: array
+ scmInfo:
+ description: The unique identifier of the Jira version.
+ type: string
+ serverTime:
+ description: The time in Jira when this request was responded to.
+ format: date-time
+ type: string
+ serverTitle:
+ description: The name of the Jira instance.
+ type: string
+ version:
+ description: The version of Jira.
+ type: string
+ versionNumbers:
+ description: The major, minor, and revision version numbers of the Jira version.
+ items:
+ format: int32
+ type: integer
+ type: array
+ type: object
+ SharePermission:
+ additionalProperties: false
+ description: Details of a share permission for the filter.
+ properties:
+ group:
+ allOf:
+ - $ref: "#/components/schemas/GroupName"
+ description: The group that the filter is shared with. For a request, specify
+ the `name` property for the group.
+ id:
+ description: The unique identifier of the share permission.
+ format: int64
+ readOnly: true
+ type: integer
+ project:
+ allOf:
+ - $ref: "#/components/schemas/Project"
+ description: >-
+ The project that the filter is shared with. This is similar to the
+ project object returned by [Get
+ project](#api-rest-api-3-project-projectIdOrKey-get) but it contains
+ a subset of the properties, which are: `self`, `id`, `key`,
+ `assigneeType`, `name`, `roles`, `avatarUrls`, `projectType`,
+ `simplified`.
+
+ For a request, specify the `id` for the project.
+ role:
+ allOf:
+ - $ref: "#/components/schemas/ProjectRole"
+ description: >-
+ The project role that the filter is shared with.
+
+ For a request, specify the `id` for the role. You must also specify the `project` object and `id` for the project that the role is in.
+ type:
+ description: >-
+ The type of share permission:
+
+ * `group` Shared with a group. If set in a request, then specify `sharePermission.group` as well.
+ * `project` Shared with a project. If set in a request, then specify `sharePermission.project` as well.
+ * `projectRole` Share with a project role in a project. This value is not returned in responses. It is used in requests, where it needs to be specify with `projectId` and `projectRoleId`.
+ * `global` Shared globally. If set in a request, no other `sharePermission` properties need to be specified.
+ * `loggedin` Shared with all logged-in users. Note: This value is set in a request by specifying `authenticated` as the `type`.
+ * `project-unknown` Shared with a project that the user does not have access to. Cannot be set in a request.
+ enum:
+ - group
+ - project
+ - projectRole
+ - global
+ - loggedin
+ - authenticated
+ - project-unknown
+ type: string
+ required:
+ - type
+ type: object
+ SharePermissionInputBean:
+ additionalProperties: false
+ properties:
+ groupname:
+ description: The name of the group to share the filter with. Set `type` to
+ `group`.
+ type: string
+ projectId:
+ description: The ID of the project to share the filter with. Set `type` to
+ `project`.
+ type: string
+ projectRoleId:
+ description: The ID of the project role to share the filter with. Set `type` to
+ `projectRole` and the `projectId` for the project that the role is
+ in.
+ type: string
+ type:
+ description: >-
+ The type of the share permission.Specify the type as follows:
+
+ * `group` Share with a group. Specify `groupname` as well.
+ * `project` Share with a project. Specify `projectId` as well.
+ * `projectRole` Share with a project role in a project. Specify `projectId` and `projectRoleId` as well.
+ * `global` Share globally, including anonymous users. If set, this type overrides all existing share permissions and must be deleted before any non-global share permissions is set.
+ * `authenticated` Share with all logged-in users. This shows as `loggedin` in the response. If set, this type overrides all existing share permissions and must be deleted before any non-global share permissions is set.
+ enum:
+ - project
+ - group
+ - projectRole
+ - global
+ - authenticated
+ type: string
+ required:
+ - type
+ type: object
+ SimpleApplicationPropertyBean:
+ additionalProperties: false
+ properties:
+ id:
+ description: The ID of the application property.
+ type: string
+ value:
+ description: The new value.
+ type: string
+ type: object
+ xml:
+ name: applicationProperty
+ SimpleErrorCollection:
+ additionalProperties: false
+ properties:
+ errorMessages:
+ description: The list of error messages produced by this operation. For example,
+ "input parameter 'key' must be provided"
+ items:
+ type: string
+ type: array
+ errors:
+ additionalProperties:
+ type: string
+ description: 'The list of errors by parameter returned by the operation. For
+ example,"projectKey": "Project keys must start with an uppercase
+ letter, followed by one or more uppercase alphanumeric characters."'
+ type: object
+ httpStatusCode:
+ format: int32
+ type: integer
+ type: object
+ SimpleLink:
+ additionalProperties: false
+ description: Details about the operations available in this version.
+ properties:
+ href:
+ type: string
+ iconClass:
+ type: string
+ id:
+ type: string
+ label:
+ type: string
+ styleClass:
+ type: string
+ title:
+ type: string
+ weight:
+ format: int32
+ type: integer
+ type: object
+ xml:
+ name: link
+ SimpleListWrapperApplicationRole:
+ additionalProperties: false
+ properties:
+ callback:
+ $ref: "#/components/schemas/ListWrapperCallbackApplicationRole"
+ items:
+ items:
+ $ref: "#/components/schemas/ApplicationRole"
+ type: array
+ max-results:
+ format: int32
+ type: integer
+ xml:
+ attribute: true
+ name: max-results
+ pagingCallback:
+ $ref: "#/components/schemas/ListWrapperCallbackApplicationRole"
+ size:
+ format: int32
+ type: integer
+ xml:
+ attribute: true
+ type: object
+ xml:
+ name: list
+ SimpleListWrapperGroupName:
+ additionalProperties: false
+ properties:
+ callback:
+ $ref: "#/components/schemas/ListWrapperCallbackGroupName"
+ items:
+ items:
+ $ref: "#/components/schemas/GroupName"
+ type: array
+ max-results:
+ format: int32
+ type: integer
+ xml:
+ attribute: true
+ name: max-results
+ pagingCallback:
+ $ref: "#/components/schemas/ListWrapperCallbackGroupName"
+ size:
+ format: int32
+ type: integer
+ xml:
+ attribute: true
+ type: object
+ xml:
+ name: list
+ Status:
+ additionalProperties: true
+ description: The status of the item.
+ properties:
+ icon:
+ allOf:
+ - $ref: "#/components/schemas/Icon"
+ description: Details of the icon representing the status. If not provided, no
+ status icon displays in Jira.
+ resolved:
+ description: Whether the item is resolved. If set to "true", the link to the
+ issue is displayed in a strikethrough font, otherwise the link
+ displays in normal font.
+ type: boolean
+ type: object
+ StatusCategory:
+ additionalProperties: true
+ description: A status category.
+ properties:
+ colorName:
+ description: The name of the color used to represent the status category.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the status category.
+ format: int64
+ readOnly: true
+ type: integer
+ key:
+ description: The key of the status category.
+ readOnly: true
+ type: string
+ name:
+ description: The name of the status category.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the status category.
+ readOnly: true
+ type: string
+ type: object
+ StatusDetails:
+ additionalProperties: true
+ description: A status.
+ properties:
+ description:
+ description: The description of the status.
+ readOnly: true
+ type: string
+ iconUrl:
+ description: The URL of the icon used to represent the status.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the status.
+ readOnly: true
+ type: string
+ name:
+ description: The name of the status.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the status.
+ readOnly: true
+ type: string
+ statusCategory:
+ allOf:
+ - $ref: "#/components/schemas/StatusCategory"
+ description: The category assigned to the status.
+ readOnly: true
+ type: object
+ StringList:
+ additionalProperties: false
+ type: object
+ SuggestedIssue:
+ additionalProperties: false
+ description: An issue suggested for use in the issue picker auto-completion.
+ properties:
+ id:
+ description: The ID of the issue.
+ format: int64
+ readOnly: true
+ type: integer
+ img:
+ description: The URL of the issue type's avatar.
+ readOnly: true
+ type: string
+ key:
+ description: The key of the issue.
+ readOnly: true
+ type: string
+ keyHtml:
+ description: The key of the issue in HTML format.
+ readOnly: true
+ type: string
+ summary:
+ description: The phrase containing the query string in HTML format, with the
+ string highlighted with HTML bold tags.
+ readOnly: true
+ type: string
+ summaryText:
+ description: The phrase containing the query string, as plain text.
+ readOnly: true
+ type: string
+ type: object
+ SystemAvatars:
+ additionalProperties: false
+ description: List of system avatars.
+ properties:
+ system:
+ description: A list of avatar details.
+ items:
+ $ref: "#/components/schemas/Avatar"
+ readOnly: true
+ type: array
+ type: object
+ TaskProgressBeanObject:
+ additionalProperties: false
+ description: Details about a task.
+ properties:
+ description:
+ description: The description of the task.
+ type: string
+ elapsedRuntime:
+ description: The execution time of the task, in milliseconds.
+ format: int64
+ type: integer
+ finished:
+ description: A timestamp recording when the task was finished.
+ format: int64
+ type: integer
+ id:
+ description: The ID of the task.
+ type: string
+ lastUpdate:
+ description: A timestamp recording when the task progress was last updated.
+ format: int64
+ type: integer
+ message:
+ description: Information about the progress of the task.
+ type: string
+ progress:
+ description: The progress of the task, as a percentage complete.
+ format: int64
+ type: integer
+ result:
+ description: The result of the task execution.
+ self:
+ description: The URL of the task.
+ format: uri
+ type: string
+ started:
+ description: A timestamp recording when the task was started.
+ format: int64
+ type: integer
+ status:
+ description: The status of the task.
+ enum:
+ - ENQUEUED
+ - RUNNING
+ - COMPLETE
+ - FAILED
+ - CANCEL_REQUESTED
+ - CANCELLED
+ - DEAD
+ type: string
+ submitted:
+ description: A timestamp recording when the task was submitted.
+ format: int64
+ type: integer
+ submittedBy:
+ description: The ID of the user who submitted the task.
+ format: int64
+ type: integer
+ required:
+ - elapsedRuntime
+ - id
+ - lastUpdate
+ - progress
+ - self
+ - status
+ - submitted
+ - submittedBy
+ type: object
+ TaskProgressBeanRemoveOptionFromIssuesResult:
+ additionalProperties: false
+ description: Details about a task.
+ properties:
+ description:
+ description: The description of the task.
+ type: string
+ elapsedRuntime:
+ description: The execution time of the task, in milliseconds.
+ format: int64
+ type: integer
+ finished:
+ description: A timestamp recording when the task was finished.
+ format: int64
+ type: integer
+ id:
+ description: The ID of the task.
+ type: string
+ lastUpdate:
+ description: A timestamp recording when the task progress was last updated.
+ format: int64
+ type: integer
+ message:
+ description: Information about the progress of the task.
+ type: string
+ progress:
+ description: The progress of the task, as a percentage complete.
+ format: int64
+ type: integer
+ result:
+ allOf:
+ - $ref: "#/components/schemas/RemoveOptionFromIssuesResult"
+ description: The result of the task execution.
+ self:
+ description: The URL of the task.
+ format: uri
+ type: string
+ started:
+ description: A timestamp recording when the task was started.
+ format: int64
+ type: integer
+ status:
+ description: The status of the task.
+ enum:
+ - ENQUEUED
+ - RUNNING
+ - COMPLETE
+ - FAILED
+ - CANCEL_REQUESTED
+ - CANCELLED
+ - DEAD
+ type: string
+ submitted:
+ description: A timestamp recording when the task was submitted.
+ format: int64
+ type: integer
+ submittedBy:
+ description: The ID of the user who submitted the task.
+ format: int64
+ type: integer
+ required:
+ - elapsedRuntime
+ - id
+ - lastUpdate
+ - progress
+ - self
+ - status
+ - submitted
+ - submittedBy
+ type: object
+ TimeTrackingConfiguration:
+ additionalProperties: false
+ description: Details of the time tracking configuration.
+ properties:
+ defaultUnit:
+ description: The default unit of time applied to logged time.
+ enum:
+ - minute
+ - hour
+ - day
+ - week
+ type: string
+ timeFormat:
+ description: The format that will appear on an issue's *Time Spent* field.
+ enum:
+ - pretty
+ - days
+ - hours
+ type: string
+ workingDaysPerWeek:
+ description: The number of days in a working week.
+ format: double
+ type: number
+ workingHoursPerDay:
+ description: The number of hours in a working day.
+ format: double
+ type: number
+ required:
+ - defaultUnit
+ - timeFormat
+ - workingDaysPerWeek
+ - workingHoursPerDay
+ type: object
+ TimeTrackingDetails:
+ additionalProperties: false
+ description: Time tracking details.
+ properties:
+ originalEstimate:
+ description: The original estimate of time needed for this issue in readable
+ format.
+ readOnly: true
+ type: string
+ originalEstimateSeconds:
+ description: The original estimate of time needed for this issue in seconds.
+ format: int64
+ readOnly: true
+ type: integer
+ remainingEstimate:
+ description: The remaining estimate of time needed for this issue in readable
+ format.
+ readOnly: true
+ type: string
+ remainingEstimateSeconds:
+ description: The remaining estimate of time needed for this issue in seconds.
+ format: int64
+ readOnly: true
+ type: integer
+ timeSpent:
+ description: Time worked on this issue in readable format.
+ readOnly: true
+ type: string
+ timeSpentSeconds:
+ description: Time worked on this issue in seconds.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ TimeTrackingProvider:
+ additionalProperties: false
+ description: Details about the time tracking provider.
+ properties:
+ key:
+ description: The key for the time tracking provider. For example, *JIRA*.
+ type: string
+ name:
+ description: The name of the time tracking provider. For example, *JIRA provided
+ time tracking*.
+ type: string
+ url:
+ description: The URL of the configuration page for the time tracking provider
+ app. For example, */example/config/url*. This property is only
+ returned if the `adminPageKey` property is set in the module
+ descriptor of the time tracking provider app.
+ readOnly: true
+ type: string
+ required:
+ - key
+ type: object
+ Transition:
+ additionalProperties: false
+ description: Details of a workflow transition.
+ properties:
+ description:
+ description: The description of the transition.
+ type: string
+ from:
+ description: The statuses the transition can start from.
+ items:
+ description: The statuses the transition can start from.
+ type: string
+ type: array
+ id:
+ description: The ID of the transition.
+ type: string
+ name:
+ description: The name of the transition.
+ type: string
+ rules:
+ $ref: "#/components/schemas/WorkflowRules"
+ screen:
+ $ref: "#/components/schemas/ScreenID"
+ to:
+ description: The status the transition goes to.
+ type: string
+ type:
+ description: The type of the transition.
+ enum:
+ - global
+ - initial
+ - directed
+ type: string
+ required:
+ - description
+ - from
+ - id
+ - name
+ - to
+ - type
+ type: object
+ Transitions:
+ additionalProperties: false
+ description: List of issue transitions.
+ properties:
+ expand:
+ description: Expand options that include additional transitions details in the
+ response.
+ readOnly: true
+ type: string
+ xml:
+ attribute: true
+ transitions:
+ description: List of issue transitions.
+ items:
+ $ref: "#/components/schemas/IssueTransition"
+ readOnly: true
+ type: array
+ type: object
+ UnrestrictedUserEmail:
+ additionalProperties: false
+ properties:
+ accountId:
+ description: The accountId of the user
+ type: string
+ email:
+ description: The email of the user
+ type: string
+ type: object
+ UpdateCustomFieldDetails:
+ additionalProperties: false
+ description: Details of a custom field.
+ properties:
+ description:
+ description: The description of the custom field. The maximum length is 40000
+ characters.
+ type: string
+ name:
+ description: The name of the custom field. It doesn't have to be unique. The
+ maximum length is 255 characters.
+ type: string
+ searcherKey:
+ description: >-
+ The searcher that defines the way the field is searched in Jira. It
+ can be set to `null`, otherwise you must specify the valid searcher
+ for the field type, as listed below (abbreviated values shown):
+
+ * `cascadingselect`: `cascadingselectsearcher`
+ * `datepicker`: `daterange`
+ * `datetime`: `datetimerange`
+ * `float`: `exactnumber` or `numberrange`
+ * `grouppicker`: `grouppickersearcher`
+ * `importid`: `exactnumber` or `numberrange`
+ * `labels`: `labelsearcher`
+ * `multicheckboxes`: `multiselectsearcher`
+ * `multigrouppicker`: `multiselectsearcher`
+ * `multiselect`: `multiselectsearcher`
+ * `multiuserpicker`: `userpickergroupsearcher`
+ * `multiversion`: `versionsearcher`
+ * `project`: `projectsearcher`
+ * `radiobuttons`: `multiselectsearcher`
+ * `readonlyfield`: `textsearcher`
+ * `select`: `multiselectsearcher`
+ * `textarea`: `textsearcher`
+ * `textfield`: `textsearcher`
+ * `url`: `exacttextsearcher`
+ * `userpicker`: `userpickergroupsearcher`
+ * `version`: `versionsearcher`
+ enum:
+ - com.atlassian.jira.plugin.system.customfieldtypes:cascadingselectsearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:daterange
+ - com.atlassian.jira.plugin.system.customfieldtypes:datetimerange
+ - com.atlassian.jira.plugin.system.customfieldtypes:exactnumber
+ - com.atlassian.jira.plugin.system.customfieldtypes:exacttextsearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:grouppickersearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:labelsearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:multiselectsearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:numberrange
+ - com.atlassian.jira.plugin.system.customfieldtypes:projectsearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:textsearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:userpickergroupsearcher
+ - com.atlassian.jira.plugin.system.customfieldtypes:versionsearcher
+ type: string
+ type: object
+ writeOnly: true
+ UpdateCustomFieldOption:
+ additionalProperties: false
+ description: Details of the options to update for a custom field.
+ properties:
+ options:
+ description: Details of the options to update.
+ items:
+ $ref: "#/components/schemas/RenamedOption"
+ type: array
+ type: object
+ writeOnly: true
+ UpdateDefaultScreenScheme:
+ additionalProperties: false
+ description: The ID of a screen scheme.
+ properties:
+ screenSchemeId:
+ description: The ID of the screen scheme.
+ type: string
+ writeOnly: true
+ required:
+ - screenSchemeId
+ type: object
+ UpdateScreenDetails:
+ additionalProperties: false
+ description: Details of a screen.
+ properties:
+ description:
+ description: The description of the screen. The maximum length is 255 characters.
+ type: string
+ writeOnly: true
+ name:
+ description: The name of the screen. The name must be unique. The maximum length
+ is 255 characters.
+ type: string
+ writeOnly: true
+ type: object
+ UpdateScreenSchemeDetails:
+ additionalProperties: false
+ description: Details of a screen scheme.
+ properties:
+ description:
+ description: The description of the screen scheme. The maximum length is 255
+ characters.
+ type: string
+ writeOnly: true
+ name:
+ description: The name of the screen scheme. The name must be unique. The maximum
+ length is 255 characters.
+ type: string
+ writeOnly: true
+ screens:
+ allOf:
+ - $ref: "#/components/schemas/UpdateScreenTypes"
+ description: The IDs of the screens for the screen types of the screen scheme.
+ Only screens used in classic projects are accepted.
+ type: object
+ UpdateScreenTypes:
+ additionalProperties: false
+ description: The IDs of the screens for the screen types of the screen scheme.
+ properties:
+ create:
+ description: The ID of the create screen. To remove the screen association, pass
+ a null.
+ type: string
+ writeOnly: true
+ default:
+ description: The ID of the default screen. When specified, must include a screen
+ ID as a default screen is required.
+ type: string
+ writeOnly: true
+ edit:
+ description: The ID of the edit screen. To remove the screen association, pass a
+ null.
+ type: string
+ writeOnly: true
+ view:
+ description: The ID of the view screen. To remove the screen association, pass a
+ null.
+ type: string
+ writeOnly: true
+ type: object
+ writeOnly: true
+ UpdateUserToGroupBean:
+ additionalProperties: true
+ properties:
+ accountId:
+ description: The account ID of the user, which uniquely identifies the user
+ across all Atlassian products. For example,
+ *5b10ac8d82e05b22cc7d4ef5*.
+ maxLength: 128
+ type: string
+ name:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ type: object
+ UpdatedProjectCategory:
+ additionalProperties: false
+ description: A project category.
+ properties:
+ description:
+ description: The name of the project category.
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the project category.
+ readOnly: true
+ type: string
+ name:
+ description: The description of the project category.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the project category.
+ readOnly: true
+ type: string
+ type: object
+ User:
+ additionalProperties: false
+ description: >-
+ A user with details as permitted by the user's Atlassian Account
+ privacy settings. However, be aware of these exceptions:
+
+ * User record deleted from Atlassian: This occurs as the result of a right to be forgotten request. In this case, `displayName` provides an indication and other parameters have default values or are blank (for example, email is blank).
+ * User record corrupted: This occurs as a results of events such as a server import and can only happen to deleted users. In this case, `accountId` returns *unknown* and all other parameters have fallback values.
+ * User record unavailable: This usually occurs due to an internal service outage. In this case, all parameters have fallback values.
+ properties:
+ accountId:
+ description: The account ID of the user, which uniquely identifies the user
+ across all Atlassian products. For example,
+ *5b10ac8d82e05b22cc7d4ef5*. Required in requests.
+ maxLength: 128
+ type: string
+ accountType:
+ description: >-
+ The user account type. Can take the following values:
+
+ * `atlassian` regular Atlassian user account
+ * `app` system account used for Connect applications and OAuth to represent external systems
+ * `customer` Jira Service Desk account representing an external service desk
+ enum:
+ - atlassian
+ - app
+ - customer
+ - unknown
+ readOnly: true
+ type: string
+ active:
+ description: Whether the user is active.
+ readOnly: true
+ type: boolean
+ applicationRoles:
+ allOf:
+ - $ref: "#/components/schemas/SimpleListWrapperApplicationRole"
+ description: The application roles the user is assigned to.
+ readOnly: true
+ avatarUrls:
+ allOf:
+ - $ref: "#/components/schemas/AvatarUrlsBean"
+ description: The avatars of the user.
+ readOnly: true
+ displayName:
+ description: The display name of the user. Depending on the user’s privacy
+ setting, this may return an alternative value.
+ readOnly: true
+ type: string
+ emailAddress:
+ description: The email address of the user. Depending on the user’s privacy
+ setting, this may be returned as null.
+ readOnly: true
+ type: string
+ expand:
+ description: Expand options that include additional user details in the response.
+ readOnly: true
+ type: string
+ xml:
+ attribute: true
+ groups:
+ allOf:
+ - $ref: "#/components/schemas/SimpleListWrapperGroupName"
+ description: The groups that the user belongs to.
+ readOnly: true
+ key:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ locale:
+ description: The locale of the user. Depending on the user’s privacy setting,
+ this may be returned as null.
+ readOnly: true
+ type: string
+ name:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ self:
+ description: The URL of the user.
+ format: uri
+ readOnly: true
+ type: string
+ timeZone:
+ description: The time zone specified in the user's profile. Depending on the
+ user’s privacy setting, this may be returned as null.
+ readOnly: true
+ type: string
+ type: object
+ xml:
+ name: user
+ UserBean:
+ additionalProperties: false
+ properties:
+ accountId:
+ description: The account ID of the user, which uniquely identifies the user
+ across all Atlassian products. For example,
+ *5b10ac8d82e05b22cc7d4ef5*.
+ maxLength: 128
+ type: string
+ active:
+ description: Whether the user is active.
+ type: boolean
+ avatarUrls:
+ allOf:
+ - $ref: "#/components/schemas/UserBeanAvatarUrls"
+ description: The avatars of the user.
+ displayName:
+ description: The display name of the user. Depending on the user’s privacy
+ setting, this may return an alternative value.
+ type: string
+ key:
+ description: >-
+ This property is deprecated in favor of `accountId` because of
+ privacy changes. See the [migration
+ guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+
+ The key of the user.
+ type: string
+ name:
+ description: >-
+ This property is deprecated in favor of `accountId` because of
+ privacy changes. See the [migration
+ guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+
+ The username of the user.
+ type: string
+ self:
+ description: The URL of the user.
+ format: uri
+ type: string
+ type: object
+ UserBeanAvatarUrls:
+ additionalProperties: false
+ properties:
+ 16x16:
+ description: The URL of the user's 16x16 pixel avatar.
+ format: uri
+ type: string
+ 24x24:
+ description: The URL of the user's 24x24 pixel avatar.
+ format: uri
+ type: string
+ 32x32:
+ description: The URL of the user's 32x32 pixel avatar.
+ format: uri
+ type: string
+ 48x48:
+ description: The URL of the user's 48x48 pixel avatar.
+ format: uri
+ type: string
+ type: object
+ UserDetails:
+ additionalProperties: false
+ description: >-
+ User details permitted by the user's Atlassian Account privacy
+ settings. However, be aware of these exceptions:
+
+ * User record deleted from Atlassian: This occurs as the result of a right to be forgotten request. In this case, `displayName` provides an indication and other parameters have default values or are blank (for example, email is blank).
+ * User record corrupted: This occurs as a results of events such as a server import and can only happen to deleted users. In this case, `accountId` returns *unknown* and all other parameters have fallback values.
+ * User record unavailable: This usually occurs due to an internal service outage. In this case, all parameters have fallback values.
+ properties:
+ accountId:
+ description: The account ID of the user, which uniquely identifies the user
+ across all Atlassian products. For example,
+ *5b10ac8d82e05b22cc7d4ef5*.
+ maxLength: 128
+ type: string
+ accountType:
+ description: The type of account represented by this user. This will be one of
+ 'atlassian' (normal users), 'app' (application user) or 'customer'
+ (Jira Service Desk customer user)
+ readOnly: true
+ type: string
+ active:
+ description: Whether the user is active.
+ readOnly: true
+ type: boolean
+ avatarUrls:
+ allOf:
+ - $ref: "#/components/schemas/AvatarUrlsBean"
+ description: The avatars of the user.
+ readOnly: true
+ displayName:
+ description: The display name of the user. Depending on the user’s privacy
+ settings, this may return an alternative value.
+ readOnly: true
+ type: string
+ emailAddress:
+ description: The email address of the user. Depending on the user’s privacy
+ settings, this may be returned as null.
+ readOnly: true
+ type: string
+ key:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ readOnly: true
+ type: string
+ name:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ readOnly: true
+ type: string
+ self:
+ description: The URL of the user.
+ readOnly: true
+ type: string
+ timeZone:
+ description: The time zone specified in the user's profile. Depending on the
+ user’s privacy settings, this may be returned as null.
+ readOnly: true
+ type: string
+ type: object
+ UserKey:
+ additionalProperties: false
+ description: List of user account IDs.
+ properties:
+ accountId:
+ description: The account ID of the user, which uniquely identifies the user
+ across all Atlassian products. For example,
+ *5b10ac8d82e05b22cc7d4ef5*. Returns *unknown* if the record is
+ deleted and corrupted, for example, as the result of a server
+ import.
+ maxLength: 128
+ type: string
+ key:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ type: object
+ UserList:
+ additionalProperties: false
+ description: A paginated list of users sharing the filter. This includes users
+ that are members of the groups or can browse the projects that the
+ filter is shared with.
+ properties:
+ end-index:
+ description: The index of the last item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ name: end-index
+ items:
+ description: The list of items.
+ items:
+ $ref: "#/components/schemas/User"
+ readOnly: true
+ type: array
+ max-results:
+ description: The maximum number of results that could be on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ name: max-results
+ size:
+ description: The number of items on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ start-index:
+ description: The index of the first item returned on the page.
+ format: int32
+ readOnly: true
+ type: integer
+ xml:
+ attribute: true
+ name: start-index
+ type: object
+ UserMigrationBean:
+ additionalProperties: false
+ properties:
+ accountId:
+ type: string
+ key:
+ type: string
+ username:
+ type: string
+ type: object
+ UserPermission:
+ additionalProperties: true
+ description: Details of a permission and its availability to a user.
+ properties:
+ deprecatedKey:
+ description: Indicate whether the permission key is deprecated. Note that
+ deprecated keys cannot be used in the `permissions parameter of Get
+ my permissions. Deprecated keys are not returned by Get all
+ permissions.`
+ type: boolean
+ description:
+ description: The description of the permission.
+ type: string
+ havePermission:
+ description: Whether the permission is available to the user in the queried
+ context.
+ type: boolean
+ id:
+ description: The ID of the permission. Either `id` or `key` must be specified.
+ Use [Get all permissions](#api-rest-api-3-permissions-get) to get
+ the list of permissions.
+ type: string
+ key:
+ description: The key of the permission. Either `id` or `key` must be specified.
+ Use [Get all permissions](#api-rest-api-3-permissions-get) to get
+ the list of permissions.
+ type: string
+ name:
+ description: The name of the permission.
+ type: string
+ type:
+ description: The type of the permission.
+ enum:
+ - GLOBAL
+ - PROJECT
+ type: string
+ type: object
+ UserPickerUser:
+ additionalProperties: false
+ description: A user found in a search.
+ properties:
+ accountId:
+ description: The account ID of the user, which uniquely identifies the user
+ across all Atlassian products. For example,
+ *5b10ac8d82e05b22cc7d4ef5*.
+ type: string
+ avatarUrl:
+ description: The avatar URL of the user.
+ format: uri
+ type: string
+ displayName:
+ description: The display name of the user. Depending on the user’s privacy
+ setting, this may be returned as null.
+ type: string
+ html:
+ description: The display name, email address, and key of the user with the
+ matched query string highlighted with the HTML bold tag.
+ type: string
+ key:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ name:
+ description: This property is no longer available and will be removed from the
+ documentation soon. See the [deprecation
+ notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ type: object
+ UserWriteBean:
+ additionalProperties: true
+ properties:
+ applicationKeys:
+ description: Deprecated, do not use.
+ items:
+ type: string
+ type: array
+ displayName:
+ description: The display name for the user.
+ type: string
+ emailAddress:
+ description: The email address for the user.
+ type: string
+ key:
+ description: The key for the user. When provided with `name`, overrides the
+ value in `name` to set both `name` and `key`. This property is
+ deprecated because of privacy changes. See the [migration
+ guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ name:
+ description: The username for the user. This property is deprecated because of
+ privacy changes. See the [migration
+ guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/)
+ for details.
+ type: string
+ password:
+ description: A password for the user. If a password is not set, a random
+ password is generated.
+ type: string
+ self:
+ description: The URL of the user.
+ readOnly: true
+ type: string
+ required:
+ - displayName
+ - emailAddress
+ type: object
+ ValueOperand:
+ description: An operand that is a user-provided value.
+ properties:
+ value:
+ description: The operand value.
+ type: string
+ required:
+ - value
+ type: object
+ Version:
+ additionalProperties: false
+ description: Details about a project version.
+ properties:
+ archived:
+ description: Indicates that the version is archived. Optional when creating or
+ updating a version.
+ type: boolean
+ description:
+ description: The description of the version. Optional when creating or updating
+ a version.
+ type: string
+ expand:
+ description: >-
+ Use [expand](em>#expansion) to include additional information about
+ version in the response. This parameter accepts a comma-separated
+ list. Expand options include:
+
+ * `operations` Returns the list of operations available for this version.
+ * `issuesstatus` Returns the count of issues in this version for each of the status categories *to do*, *in progress*, *done*, and *unmapped*. The *unmapped* property contains a count of issues with a status other than *to do*, *in progress*, and *done*.
+
+ Optional for create and update.
+ type: string
+ xml:
+ attribute: true
+ id:
+ description: The ID of the version.
+ readOnly: true
+ type: string
+ issuesStatusForFixVersion:
+ allOf:
+ - $ref: "#/components/schemas/VersionIssuesStatus"
+ description: If the expand option `issuesstatus` is used, returns the count of
+ issues in this version for each of the status categories *to do*,
+ *in progress*, *done*, and *unmapped*. The *unmapped* property
+ contains a count of issues with a status other than *to do*, *in
+ progress*, and *done*.
+ readOnly: true
+ moveUnfixedIssuesTo:
+ description: The URL of the self link to the version to which all unfixed issues
+ are moved when a version is released. Not applicable when creating a
+ version. Optional when updating a version.
+ format: uri
+ type: string
+ name:
+ description: The unique name of the version. Required when creating a version.
+ Optional when updating a version. The maximum length is 255
+ characters.
+ type: string
+ operations:
+ description: If the expand option `operations` is used, returns the list of
+ operations available for this version.
+ items:
+ $ref: "#/components/schemas/SimpleLink"
+ readOnly: true
+ type: array
+ overdue:
+ description: Indicates that the version is overdue.
+ readOnly: true
+ type: boolean
+ project:
+ description: Deprecated. Use `projectId`.
+ type: string
+ projectId:
+ description: The ID of the project to which this version is attached. Required
+ when creating a version. Not applicable when updating a version.
+ format: int64
+ type: integer
+ releaseDate:
+ description: The release date of the version. Expressed in ISO 8601 format
+ (yyyy-mm-dd). Optional when creating or updating a version.
+ format: date
+ type: string
+ released:
+ description: Indicates that the version is released. If the version is released
+ a request to release again is ignored. Not applicable when creating
+ a version. Optional when updating a version.
+ type: boolean
+ self:
+ description: The URL of the version.
+ format: uri
+ readOnly: true
+ type: string
+ startDate:
+ description: The start date of the version. Expressed in ISO 8601 format
+ (yyyy-mm-dd). Optional when creating or updating a version.
+ format: date
+ type: string
+ userReleaseDate:
+ description: The date on which work on this version is expected to finish,
+ expressed in the instance's *Day/Month/Year Format* date format.
+ readOnly: true
+ type: string
+ userStartDate:
+ description: The date on which work on this version is expected to start,
+ expressed in the instance's *Day/Month/Year Format* date format.
+ readOnly: true
+ type: string
+ type: object
+ xml:
+ name: version
+ VersionIssueCounts:
+ additionalProperties: false
+ description: Various counts of issues within a version.
+ properties:
+ customFieldUsage:
+ description: List of custom fields using the version.
+ items:
+ $ref: "#/components/schemas/VersionUsageInCustomField"
+ readOnly: true
+ type: array
+ issueCountWithCustomFieldsShowingVersion:
+ description: Count of issues where a version custom field is set to the version.
+ format: int64
+ readOnly: true
+ type: integer
+ issuesAffectedCount:
+ description: Count of issues where the `affectedVersion` is set to the version.
+ format: int64
+ readOnly: true
+ type: integer
+ issuesFixedCount:
+ description: Count of issues where the `fixVersion` is set to the version.
+ format: int64
+ readOnly: true
+ type: integer
+ self:
+ description: The URL of these count details.
+ format: uri
+ readOnly: true
+ type: string
+ type: object
+ xml:
+ name: version
+ VersionIssuesStatus:
+ additionalProperties: true
+ description: Counts of the number of issues in various statuses.
+ properties:
+ done:
+ description: Count of issues with status *done*.
+ format: int64
+ readOnly: true
+ type: integer
+ inProgress:
+ description: Count of issues with status *in progress*.
+ format: int64
+ readOnly: true
+ type: integer
+ toDo:
+ description: Count of issues with status *to do*.
+ format: int64
+ readOnly: true
+ type: integer
+ unmapped:
+ description: Count of issues with a status other than *to do*, *in progress*,
+ and *done*.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ VersionMoveBean:
+ additionalProperties: false
+ properties:
+ after:
+ description: The URL (self link) of the version after which to place the moved
+ version. Cannot be used with `position`.
+ format: uri
+ type: string
+ position:
+ description: An absolute position in which to place the moved version. Cannot be
+ used with `after`.
+ enum:
+ - Earlier
+ - Later
+ - First
+ - Last
+ type: string
+ type: object
+ xml:
+ name: version
+ VersionUnresolvedIssuesCount:
+ additionalProperties: false
+ description: Count of a version's unresolved issues.
+ properties:
+ issuesCount:
+ description: Count of issues.
+ format: int64
+ readOnly: true
+ type: integer
+ issuesUnresolvedCount:
+ description: Count of unresolved issues.
+ format: int64
+ readOnly: true
+ type: integer
+ self:
+ description: The URL of these count details.
+ format: uri
+ readOnly: true
+ type: string
+ type: object
+ xml:
+ name: version
+ VersionUsageInCustomField:
+ additionalProperties: false
+ description: List of custom fields using the version.
+ properties:
+ customFieldId:
+ description: The ID of the custom field.
+ format: int64
+ readOnly: true
+ type: integer
+ fieldName:
+ description: The name of the custom field.
+ readOnly: true
+ type: string
+ issueCountWithVersionInCustomField:
+ description: Count of the issues where the custom field contains the version.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ Visibility:
+ additionalProperties: true
+ description: The group or role to which this item is visible.
+ properties:
+ type:
+ description: Whether visibility of this item is restricted to a group or role.
+ enum:
+ - group
+ - role
+ type: string
+ value:
+ description: The name of the group or role to which visibility of this item is
+ restricted.
+ type: string
+ type: object
+ Votes:
+ additionalProperties: false
+ description: The details of votes on an issue.
+ properties:
+ hasVoted:
+ description: Whether the user making this request has voted on the issue.
+ readOnly: true
+ type: boolean
+ self:
+ description: The URL of these issue vote details.
+ format: uri
+ readOnly: true
+ type: string
+ voters:
+ description: List of the users who have voted on this issue. An empty list is
+ returned when the calling user doesn't have the *View voters and
+ watchers* project permission.
+ items:
+ $ref: "#/components/schemas/User"
+ readOnly: true
+ type: array
+ votes:
+ description: The number of votes on the issue.
+ format: int64
+ readOnly: true
+ type: integer
+ type: object
+ Watchers:
+ additionalProperties: false
+ description: The details of watchers on an issue.
+ properties:
+ isWatching:
+ description: Whether the calling user is watching this issue.
+ readOnly: true
+ type: boolean
+ self:
+ description: The URL of these issue watcher details.
+ readOnly: true
+ type: string
+ watchCount:
+ description: The number of users watching this issue.
+ format: int32
+ readOnly: true
+ type: integer
+ watchers:
+ description: Details of the users watching this issue.
+ items:
+ $ref: "#/components/schemas/UserDetails"
+ readOnly: true
+ type: array
+ type: object
+ xml:
+ name: watchers
+ Webhook:
+ additionalProperties: false
+ description: A webhook.
+ properties:
+ events:
+ description: The Jira events that trigger the webhook.
+ items:
+ enum:
+ - jira:issue_created
+ - jira:issue_updated
+ - jira:issue_deleted
+ - comment_created
+ - comment_updated
+ - comment_deleted
+ - issue_property_set
+ - issue_property_deleted
+ type: string
+ type: array
+ expirationDate:
+ format: int64
+ readOnly: true
+ type: integer
+ id:
+ description: The ID of the webhook.
+ format: int64
+ type: integer
+ jqlFilter:
+ description: The JQL filter that specifies which issues the webhook is sent for.
+ type: string
+ required:
+ - events
+ - expirationDate
+ - id
+ - jqlFilter
+ type: object
+ WebhookDetails:
+ additionalProperties: false
+ description: A list of webhooks.
+ properties:
+ events:
+ description: The Jira events that trigger the webhook.
+ items:
+ enum:
+ - jira:issue_created
+ - jira:issue_updated
+ - jira:issue_deleted
+ - comment_created
+ - comment_updated
+ - comment_deleted
+ - issue_property_set
+ - issue_property_deleted
+ type: string
+ type: array
+ jqlFilter:
+ description: >-
+ The JQL filter that specifies which issues the webhook is sent for.
+ Only a subset of JQL can be used. The supported elements are:
+
+ * Fields: `issueKey`, `project`, `issuetype`, `status`, `assignee`, `reporter`, `issue.property`, and `cf[id]` (for custom fields—only the epic label custom field is supported).
+ * Operators: `=`, `!=`, `IN`, and `NOT IN`.
+ type: string
+ required:
+ - events
+ - jqlFilter
+ type: object
+ WebhookRegistrationDetails:
+ additionalProperties: false
+ description: Details of webhooks to register.
+ properties:
+ url:
+ description: The URL that specifies where to send the webhooks. This URL must
+ use the same base URL as the Connect app.
+ type: string
+ webhooks:
+ description: A list of webhooks.
+ items:
+ $ref: "#/components/schemas/WebhookDetails"
+ type: array
+ required:
+ - url
+ - webhooks
+ type: object
+ WebhooksExpirationDate:
+ additionalProperties: false
+ description: The date the newly refreshed webhooks expire.
+ properties:
+ expirationDate:
+ format: int64
+ readOnly: true
+ type: integer
+ required:
+ - expirationDate
+ type: object
+ Workflow:
+ additionalProperties: false
+ description: Details about a workflow.
+ properties:
+ description:
+ description: The description of the workflow.
+ type: string
+ id:
+ $ref: "#/components/schemas/PublishedWorkflowId"
+ isDefault:
+ description: Whether this is the default workflow.
+ type: boolean
+ statuses:
+ description: The statuses of the workflow.
+ items:
+ $ref: "#/components/schemas/WorkflowStatus"
+ type: array
+ transitions:
+ description: The transitions of the workflow.
+ items:
+ $ref: "#/components/schemas/Transition"
+ type: array
+ required:
+ - description
+ - id
+ type: object
+ WorkflowCompoundCondition:
+ description: A workflow transition compound condition rule.
+ properties:
+ conditions:
+ description: The list of workflow conditions.
+ items:
+ $ref: "#/components/schemas/WorkflowConditionBean"
+ type: array
+ nodeType:
+ type: string
+ operator:
+ description: The conditions operator.
+ enum:
+ - AND
+ - OR
+ type: string
+ required:
+ - conditions
+ - nodeType
+ - operator
+ type: object
+ WorkflowConditionBean:
+ additionalProperties: false
+ description: The workflow conditions tree.
+ discriminator:
+ mapping:
+ compound: "#/components/schemas/WorkflowCompoundCondition"
+ simple: "#/components/schemas/WorkflowSimpleCondition"
+ propertyName: nodeType
+ oneOf:
+ - $ref: "#/components/schemas/WorkflowSimpleCondition"
+ - $ref: "#/components/schemas/WorkflowCompoundCondition"
+ type: object
+ WorkflowIDs:
+ additionalProperties: false
+ description: The classic workflow identifiers.
+ properties:
+ entityId:
+ description: The entity ID of the workflow.
+ type: string
+ name:
+ description: The name of the workflow.
+ type: string
+ required:
+ - name
+ type: object
+ WorkflowId:
+ additionalProperties: false
+ description: Properties that identify a workflow.
+ properties:
+ draft:
+ description: Whether the workflow is in the draft state.
+ type: boolean
+ name:
+ description: The name of the workflow.
+ type: string
+ required:
+ - draft
+ - name
+ type: object
+ WorkflowRules:
+ additionalProperties: false
+ description: A collection of transition rules.
+ properties:
+ conditions:
+ description: The workflow conditions.
+ items:
+ $ref: "#/components/schemas/WorkflowTransitionRule"
+ type: array
+ conditionsTree:
+ $ref: "#/components/schemas/WorkflowConditionBean"
+ postFunctions:
+ description: The workflow post functions.
+ items:
+ $ref: "#/components/schemas/WorkflowTransitionRule"
+ type: array
+ validators:
+ description: The workflow validators.
+ items:
+ $ref: "#/components/schemas/WorkflowTransitionRule"
+ type: array
+ required:
+ - conditions
+ - postFunctions
+ - validators
+ type: object
+ WorkflowScheme:
+ additionalProperties: false
+ description: Details about a workflow scheme.
+ properties:
+ defaultWorkflow:
+ description: The name of the default workflow for the workflow scheme. The
+ default workflow has *All Unassigned Issue Types* assigned to it in
+ Jira. If `defaultWorkflow` is not specified when creating a workflow
+ scheme, it is set to *Jira Workflow (jira)*.
+ type: string
+ description:
+ description: The description of the workflow scheme.
+ type: string
+ draft:
+ description: Whether the workflow scheme is a draft or not.
+ readOnly: true
+ type: boolean
+ id:
+ description: The ID of the workflow scheme.
+ format: int64
+ readOnly: true
+ type: integer
+ issueTypeMappings:
+ additionalProperties:
+ type: string
+ description: The issue type to workflow mappings, where each mapping is an issue
+ type ID and workflow name pair. Note that an issue type can only be
+ mapped to one workflow in a workflow scheme.
+ type: object
+ issueTypes:
+ additionalProperties:
+ $ref: "#/components/schemas/IssueTypeDetails"
+ description: The issue types available in Jira.
+ readOnly: true
+ type: object
+ lastModified:
+ description: The date-time that the draft workflow scheme was last modified. A
+ modification is a change to the issue type-project mappings only.
+ This property does not apply to non-draft workflows.
+ readOnly: true
+ type: string
+ lastModifiedUser:
+ allOf:
+ - $ref: "#/components/schemas/User"
+ description: The user that last modified the draft workflow scheme. A
+ modification is a change to the issue type-project mappings only.
+ This property does not apply to non-draft workflows.
+ readOnly: true
+ name:
+ description: The name of the workflow scheme. The name must be unique. The
+ maximum length is 255 characters. Required when creating a workflow
+ scheme.
+ type: string
+ originalDefaultWorkflow:
+ description: For draft workflow schemes, this property is the name of the
+ default workflow for the original workflow scheme. The default
+ workflow has *All Unassigned Issue Types* assigned to it in Jira.
+ readOnly: true
+ type: string
+ originalIssueTypeMappings:
+ additionalProperties:
+ readOnly: true
+ type: string
+ description: For draft workflow schemes, this property is the issue type to
+ workflow mappings for the original workflow scheme, where each
+ mapping is an issue type ID and workflow name pair. Note that an
+ issue type can only be mapped to one workflow in a workflow scheme.
+ readOnly: true
+ type: object
+ self:
+ format: uri
+ readOnly: true
+ type: string
+ updateDraftIfNeeded:
+ description: >-
+ Whether to create or update a draft workflow scheme when updating
+ an active workflow scheme. An active workflow scheme is a workflow
+ scheme that is used by at least one project. The following examples
+ show how this property works:
+
+ * Update an active workflow scheme with `updateDraftIfNeeded` set to `true`: If a draft workflow scheme exists, it is updated. Otherwise, a draft workflow scheme is created.
+ * Update an active workflow scheme with `updateDraftIfNeeded` set to `false`: An error is returned, as active workflow schemes cannot be updated.
+ * Update an inactive workflow scheme with `updateDraftIfNeeded` set to `true`: The workflow scheme is updated, as inactive workflow schemes do not require drafts to update.
+
+ Defaults to `false`.
+ type: boolean
+ type: object
+ WorkflowSchemeAssociations:
+ additionalProperties: false
+ description: A workflow scheme along with a list of projects that use it.
+ properties:
+ projectIds:
+ description: The list of projects that use the workflow scheme.
+ items:
+ type: string
+ type: array
+ workflowScheme:
+ allOf:
+ - $ref: "#/components/schemas/WorkflowScheme"
+ description: The workflow scheme.
+ required:
+ - projectIds
+ - workflowScheme
+ type: object
+ WorkflowSchemeProjectAssociation:
+ additionalProperties: false
+ description: An associated workflow scheme and project.
+ properties:
+ projectId:
+ description: The ID of the project.
+ type: string
+ workflowSchemeId:
+ description: The ID of the workflow scheme. If the workflow scheme ID is `null`,
+ the operation assigns the default workflow scheme.
+ type: string
+ required:
+ - projectId
+ type: object
+ WorkflowSimpleCondition:
+ description: A workflow transition condition rule.
+ properties:
+ configuration:
+ description: The configuration of the transition rule. This is currently
+ returned only for some of the rule types. Availability of this
+ property is subject to change.
+ type: object
+ nodeType:
+ type: string
+ type:
+ description: The type of the transition rule.
+ type: string
+ required:
+ - nodeType
+ - type
+ type: object
+ WorkflowStatus:
+ additionalProperties: false
+ description: Details of a workflow status.
+ properties:
+ id:
+ description: The ID of the issue status.
+ type: string
+ name:
+ description: The name of the status in the workflow.
+ type: string
+ properties:
+ $ref: "#/components/schemas/WorkflowStatusProperties"
+ required:
+ - id
+ - name
+ type: object
+ WorkflowStatusProperties:
+ additionalProperties: false
+ description: Properties of a workflow status.
+ properties:
+ issueEditable:
+ description: Whether issues are editable in this status.
+ type: boolean
+ required:
+ - issueEditable
+ type: object
+ WorkflowTransition:
+ additionalProperties: false
+ description: A workflow transition.
+ properties:
+ id:
+ description: The transition ID.
+ format: int32
+ type: integer
+ name:
+ description: The transition name.
+ type: string
+ required:
+ - id
+ - name
+ type: object
+ WorkflowTransitionProperty:
+ additionalProperties: true
+ description: Details about the server Jira is running on.
+ properties:
+ id:
+ description: The ID of the transition property.
+ readOnly: true
+ type: string
+ key:
+ description: The key of the transition property. Also known as the name of the
+ transition property.
+ readOnly: true
+ type: string
+ value:
+ description: The value of the transition property.
+ type: string
+ required:
+ - value
+ type: object
+ WorkflowTransitionRule:
+ additionalProperties: false
+ description: A workflow transition rule.
+ properties:
+ configuration:
+ description: The configuration of the transition rule. This is currently
+ returned only for some of the rule types. Availability of this
+ property is subject to change.
+ type:
+ description: The type of the transition rule.
+ type: string
+ required:
+ - type
+ type: object
+ WorkflowTransitionRules:
+ additionalProperties: false
+ description: A workflow with transition rules.
+ properties:
+ conditions:
+ description: The list of conditions within the workflow.
+ items:
+ $ref: "#/components/schemas/ConnectWorkflowTransitionRule"
+ type: array
+ postFunctions:
+ description: The list of post functions within the workflow.
+ items:
+ $ref: "#/components/schemas/ConnectWorkflowTransitionRule"
+ type: array
+ validators:
+ description: The list of validators within the workflow.
+ items:
+ $ref: "#/components/schemas/ConnectWorkflowTransitionRule"
+ type: array
+ workflowId:
+ $ref: "#/components/schemas/WorkflowId"
+ required:
+ - conditions
+ - postFunctions
+ - validators
+ - workflowId
+ type: object
+ WorkflowTransitionRulesUpdate:
+ additionalProperties: false
+ description: Details about a workflow configuration update request.
+ properties:
+ workflows:
+ description: The list of workflows with transition rules to update.
+ items:
+ $ref: "#/components/schemas/WorkflowTransitionRules"
+ type: array
+ required:
+ - workflows
+ type: object
+ WorkflowTransitionRulesUpdateErrorDetails:
+ additionalProperties: false
+ description: Details of any errors encountered while updating workflow
+ transition rules for a workflow.
+ properties:
+ ruleUpdateErrors:
+ additionalProperties:
+ description: A list of transition rule update errors, indexed by the transition
+ rule ID. Any transition rule that appears here wasn't updated.
+ items:
+ description: A list of transition rule update errors, indexed by the transition
+ rule ID. Any transition rule that appears here wasn't updated.
+ type: string
+ type: array
+ uniqueItems: true
+ description: A list of transition rule update errors, indexed by the transition
+ rule ID. Any transition rule that appears here wasn't updated.
+ type: object
+ updateErrors:
+ description: The list of errors that specify why the workflow update failed. The
+ workflow was not updated if the list contains any entries.
+ items:
+ description: An error specifying why the workflow update failed.
+ type: string
+ type: array
+ uniqueItems: true
+ workflowId:
+ $ref: "#/components/schemas/WorkflowId"
+ required:
+ - ruleUpdateErrors
+ - updateErrors
+ - workflowId
+ type: object
+ WorkflowTransitionRulesUpdateErrors:
+ additionalProperties: false
+ description: Details of any errors encountered while updating workflow
+ transition rules.
+ properties:
+ updateResults:
+ description: A list of workflows.
+ items:
+ $ref: "#/components/schemas/WorkflowTransitionRulesUpdateErrorDetails"
+ type: array
+ required:
+ - updateResults
+ type: object
+ Worklog:
+ additionalProperties: true
+ description: Details of a worklog.
+ properties:
+ author:
+ allOf:
+ - $ref: "#/components/schemas/UserDetails"
+ description: Details of the user who created the worklog.
+ readOnly: true
+ comment:
+ description: A comment about the worklog in [Atlassian Document
+ Format](https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/).
+ Optional when creating or updating a worklog.
+ created:
+ description: The datetime on which the worklog was created.
+ format: date-time
+ readOnly: true
+ type: string
+ id:
+ description: The ID of the worklog record.
+ readOnly: true
+ type: string
+ issueId:
+ description: The ID of the issue this worklog is for.
+ readOnly: true
+ type: string
+ properties:
+ description: Details of properties for the worklog. Optional when creating or
+ updating a worklog.
+ items:
+ $ref: "#/components/schemas/EntityProperty"
+ type: array
+ self:
+ description: The URL of the worklog item.
+ format: uri
+ readOnly: true
+ type: string
+ started:
+ description: The datetime on which the worklog effort was started. Required when
+ creating a worklog. Optional when updating a worklog.
+ format: date-time
+ type: string
+ timeSpent:
+ description: The time spent working on the issue as days (\#d), hours (\#h), or
+ minutes (\#m or \#). Required when creating a worklog if
+ `timeSpentSeconds` isn't provided. Optional when updating a worklog.
+ Cannot be provided if `timeSpentSecond` is provided.
+ type: string
+ timeSpentSeconds:
+ description: The time in seconds spent working on the issue. Required when
+ creating a worklog if `timeSpent` isn't provided. Optional when
+ updating a worklog. Cannot be provided if `timeSpent` is provided.
+ format: int64
+ type: integer
+ updateAuthor:
+ allOf:
+ - $ref: "#/components/schemas/UserDetails"
+ description: Details of the user who last updated the worklog.
+ readOnly: true
+ updated:
+ description: The datetime on which the worklog was last updated.
+ format: date-time
+ readOnly: true
+ type: string
+ visibility:
+ allOf:
+ - $ref: "#/components/schemas/Visibility"
+ description: Details about any restrictions in the visibility of the worklog.
+ Optional when creating or updating a worklog.
+ type: object
+ xml:
+ name: worklog
+ WorklogIdsRequestBean:
+ additionalProperties: false
+ properties:
+ ids:
+ description: A list of worklog IDs.
+ items:
+ format: int64
+ type: integer
+ type: array
+ uniqueItems: true
+ required:
+ - ids
+ type: object
+ securitySchemes:
+ OAuth2:
+ description: OAuth2 scopes for Jira
+ flows:
+ authorizationCode:
+ authorizationUrl: https://auth.atlassian.com/authorize
+ scopes:
+ manage:jira-configuration: Configure Jira settings that require the Jira
+ administrators permission, for example, create projects and custom
+ fields, view workflows, manage issue link types.
+ manage:jira-project: Create and edit project settings and create new
+ project-level objects, for example, versions, components.
+ manage:jira-webhook: Manage Jira webhooks. Enables an OAuth app to register and
+ unregister dynamic webhooks in Jira. It also provides for fetching
+ of registered webhooks.
+ read:jira-user: View user information in Jira that you have access to, including
+ usernames, email addresses, and avatars.
+ read:jira-work: Read project and issue data. Search for issues and objects
+ associated with issues (such as attachments and worklogs).
+ write:jira-work: Create and edit issues in Jira, post comments, create worklogs,
+ and delete issues.
+ tokenUrl: https://auth.atlassian.com/oauth/token
+ type: oauth2
+ basicAuth:
+ description: You can access this resource via basic auth.
+ scheme: basic
+ type: http
+x-atlassian-narrative:
+ documents:
+ - anchor: about
+ body: >-
+ The Jira REST API enables you to interact with Jira programmatically. Use
+ this API to
+
+ [build apps](https://developer.atlassian.com/cloud/jira/platform/integrating-with-jira-cloud/), script interactions with
+
+ Jira, or develop any other type of integration. This page documents the REST resources available in Jira Cloud, including
+
+ the HTTP response codes and example requests and responses.
+ title: About
+ - anchor: version
+ body: >-
+ This documentation is for **version 3** of the Jira Cloud platform REST
+ API, which is the latest version.
+
+
+ The URIs for resources have the following structure:
+
+
+ `https://You can use AWS Certificate Manager (ACM) to manage SSL/TLS certificates for your AWS-based websites and applications. For more information about using ACM, see the AWS Certificate Manager User Guide.
' + 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: acm + x-origin: + - contentType: application/json + url: 'https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/acm-2015-12-08.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/acm/' +servers: + - url: 'http://acm.{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 ACM multi-region endpoint + - url: 'https://acm.{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 ACM multi-region endpoint + - url: 'http://acm.{region}.amazonaws.com.cn' + variables: + region: + description: The AWS region + enum: + - cn-north-1 + - cn-northwest-1 + default: cn-north-1 + description: The ACM endpoint for China (Beijing) and China (Ningxia) + - url: 'https://acm.{region}.amazonaws.com.cn' + variables: + region: + description: The AWS region + enum: + - cn-north-1 + - cn-northwest-1 + default: cn-north-1 + description: The ACM endpoint for China (Beijing) and China (Ningxia) +x-hasEquivalentPaths: true +paths: + /#X-Amz-Target=CertificateManager.AddTagsToCertificate: + post: + operationId: AddTagsToCertificate + description: 'Adds one or more tags to an ACM certificate. Tags are labels that you can use to identify and organize your AWS resources. Each tag consists of a key and an optional value. You specify the certificate on input by its Amazon Resource Name (ARN). You specify the tag by using a key-value pair.
You can apply a tag to just one certificate if you want to identify a specific characteristic of that certificate, or you can apply the same tag to multiple certificates if you want to filter for a common relationship among those certificates. Similarly, you can apply the same tag to multiple resources if you want to specify a relationship among those resources. For example, you can add the same tag to an ACM certificate and an Elastic Load Balancing load balancer to indicate that they are both used by the same website. For more information, see Tagging ACM certificates.
To remove one or more tags, use the RemoveTagsFromCertificate action. To view all of the tags that have been applied to the certificate, use the ListTagsForCertificate action.
' + responses: + '200': + description: Success + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + '482': + description: InvalidTagException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidTagException' + '483': + description: TooManyTagsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyTagsException' + '484': + description: TagPolicyException + content: + application/json: + schema: + $ref: '#/components/schemas/TagPolicyException' + '485': + description: InvalidParameterException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidParameterException' + '486': + description: ThrottlingException + content: + application/json: + schema: + $ref: '#/components/schemas/ThrottlingException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/AddTagsToCertificateRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.AddTagsToCertificate + 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' + /#X-Amz-Target=CertificateManager.DeleteCertificate: + post: + operationId: DeleteCertificate + description: 'Deletes a certificate and its associated private key. If this action succeeds, the certificate no longer appears in the list that can be displayed by calling the ListCertificates action or be retrieved by calling the GetCertificate action. The certificate will not be available for use by AWS services integrated with ACM.
You cannot delete an ACM certificate that is being used by another AWS service. To delete a certificate that is in use, the certificate association must first be removed.
Exports a private certificate issued by a private certificate authority (CA) for use anywhere. The exported file contains the certificate, the certificate chain, and the encrypted private 2048-bit RSA key associated with the public key that is embedded in the certificate. For security, you must assign a passphrase for the private key when exporting it.
For information about exporting and formatting a certificate using the ACM console or CLI, see Export a Private Certificate.
' + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/ExportCertificateResponse' + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: RequestInProgressException + content: + application/json: + schema: + $ref: '#/components/schemas/RequestInProgressException' + '482': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/ExportCertificateRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.ExportCertificate + 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' + /#X-Amz-Target=CertificateManager.GetAccountConfiguration: + post: + operationId: GetAccountConfiguration + description: Returns the account configuration options associated with an AWS account. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetAccountConfigurationResponse' + '480': + description: AccessDeniedException + content: + application/json: + schema: + $ref: '#/components/schemas/AccessDeniedException' + '481': + description: ThrottlingException + content: + application/json: + schema: + $ref: '#/components/schemas/ThrottlingException' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.GetAccountConfiguration + 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' + /#X-Amz-Target=CertificateManager.GetCertificate: + post: + operationId: GetCertificate + description: 'Retrieves an Amazon-issued certificate and its certificate chain. The chain consists of the certificate of the issuing CA and the intermediate certificates of any other subordinate CAs. All of the certificates are base64 encoded. You can use OpenSSL to decode the certificates and inspect individual fields.' + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetCertificateResponse' + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: RequestInProgressException + content: + application/json: + schema: + $ref: '#/components/schemas/RequestInProgressException' + '482': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/GetCertificateRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.GetCertificate + 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' + /#X-Amz-Target=CertificateManager.ImportCertificate: + post: + operationId: ImportCertificate + description: 'Imports a certificate into AWS Certificate Manager (ACM) to use with services that are integrated with ACM. Note that integrated services allow only certificate types and keys they support to be associated with their resources. Further, their support differs depending on whether the certificate is imported into IAM or into ACM. For more information, see the documentation for each service. For more information about importing certificates into ACM, see Importing Certificates in the AWS Certificate Manager User Guide.
ACM does not provide managed renewal for certificates that you import.
Note the following guidelines when importing third party certificates:
You must enter the private key that matches the certificate you are importing.
The private key must be unencrypted. You cannot import a private key that is protected by a password or a passphrase.
The private key must be no larger than 5 KB (5,120 bytes).
If the certificate you are importing is not self-signed, you must enter its certificate chain.
If a certificate chain is included, the issuer must be the subject of one of the certificates in the chain.
The certificate, private key, and certificate chain must be PEM-encoded.
The current time must be between the Not Before and Not After certificate fields.
The Issuer field must not be empty.
The OCSP authority URL, if present, must not exceed 1000 characters.
To import a new certificate, omit the CertificateArn argument. Include this argument only when you want to replace a previously imported certificate.
When you import a certificate by using the CLI, you must specify the certificate, the certificate chain, and the private key by their file names preceded by fileb://. For example, you can specify a certificate saved in the C:\temp folder as fileb://C:\temp\certificate_to_import.pem. If you are making an HTTP or HTTPS Query request, include these arguments as BLOBs.
When you import a certificate by using an SDK, you must specify the certificate, the certificate chain, and the private key files in the manner required by the programming language you''re using.
The cryptographic algorithm of an imported certificate must match the algorithm of the signing CA. For example, if the signing CA key type is RSA, then the certificate key type must also be RSA.
This operation returns the Amazon Resource Name (ARN) of the imported certificate.
' + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/ImportCertificateResponse' + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: LimitExceededException + content: + application/json: + schema: + $ref: '#/components/schemas/LimitExceededException' + '482': + description: InvalidTagException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidTagException' + '483': + description: TooManyTagsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyTagsException' + '484': + description: TagPolicyException + content: + application/json: + schema: + $ref: '#/components/schemas/TagPolicyException' + '485': + description: InvalidParameterException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidParameterException' + '486': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/ImportCertificateRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.ImportCertificate + 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' + /#X-Amz-Target=CertificateManager.ListCertificates: + post: + operationId: ListCertificates + description: 'Retrieves a list of certificate ARNs and domain names. You can request that only certificates that match a specific status be listed. You can also filter by specific attributes of the certificate. Default filtering returns onlyRSA_2048 certificates. For more information, see Filters.'
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ListCertificatesResponse'
+ '480':
+ description: InvalidArgsException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InvalidArgsException'
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ListCertificatesRequest'
+ parameters:
+ - name: MaxItems
+ in: query
+ schema:
+ type: string
+ description: Pagination limit
+ required: false
+ - name: NextToken
+ in: query
+ schema:
+ type: string
+ description: Pagination token
+ required: false
+ - name: X-Amz-Target
+ in: header
+ required: true
+ schema:
+ type: string
+ enum:
+ - CertificateManager.ListCertificates
+ 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'
+ /#X-Amz-Target=CertificateManager.ListTagsForCertificate:
+ post:
+ operationId: ListTagsForCertificate
+ description: 'Lists the tags that have been applied to the ACM certificate. Use the certificate''s Amazon Resource Name (ARN) to specify the certificate. To add a tag to an ACM certificate, use the AddTagsToCertificate action. To delete a tag, use the RemoveTagsFromCertificate action. '
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ListTagsForCertificateResponse'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InvalidArnException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InvalidArnException'
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ListTagsForCertificateRequest'
+ parameters:
+ - name: X-Amz-Target
+ in: header
+ required: true
+ schema:
+ type: string
+ enum:
+ - CertificateManager.ListTagsForCertificate
+ 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'
+ /#X-Amz-Target=CertificateManager.PutAccountConfiguration:
+ post:
+ operationId: PutAccountConfiguration
+ description: 'Adds or modifies account-level configurations in ACM.
The supported configuration option is DaysBeforeExpiry. This option specifies the number of days prior to certificate expiration when ACM starts generating EventBridge events. ACM sends one event per day per certificate until the certificate expires. By default, accounts receive events starting 45 days before certificate expiration.
Remove one or more tags from an ACM certificate. A tag consists of a key-value pair. If you do not specify the value portion of the tag when calling this function, the tag will be removed regardless of value. If you specify a value, the tag is removed only if it is associated with the specified value.
To add tags to a certificate, use the AddTagsToCertificate action. To view all of the tags that have been applied to a specific ACM certificate, use the ListTagsForCertificate action.
' + responses: + '200': + description: Success + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + '482': + description: InvalidTagException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidTagException' + '483': + description: TagPolicyException + content: + application/json: + schema: + $ref: '#/components/schemas/TagPolicyException' + '484': + description: InvalidParameterException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidParameterException' + '485': + description: ThrottlingException + content: + application/json: + schema: + $ref: '#/components/schemas/ThrottlingException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/RemoveTagsFromCertificateRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.RemoveTagsFromCertificate + 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' + /#X-Amz-Target=CertificateManager.RenewCertificate: + post: + operationId: RenewCertificate + description: 'Renews an eligible ACM certificate. At this time, only exported private certificates can be renewed with this operation. In order to renew your ACM PCA certificates with ACM, you must first grant the ACM service principal permission to do so. For more information, see Testing Managed Renewal in the ACM User Guide.' + responses: + '200': + description: Success + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/RenewCertificateRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.RenewCertificate + 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' + /#X-Amz-Target=CertificateManager.RequestCertificate: + post: + operationId: RequestCertificate + description: 'Requests an ACM certificate for use with other AWS services. To request an ACM certificate, you must specify a fully qualified domain name (FQDN) in the DomainName parameter. You can also specify additional FQDNs in the SubjectAlternativeNames parameter.
If you are requesting a private certificate, domain validation is not required. If you are requesting a public certificate, each domain name that you specify must be validated to verify that you own or control the domain. You can use DNS validation or email validation. We recommend that you use DNS validation. ACM issues public certificates after receiving approval from the domain owner.
' + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/RequestCertificateResponse' + '480': + description: LimitExceededException + content: + application/json: + schema: + $ref: '#/components/schemas/LimitExceededException' + '481': + description: InvalidDomainValidationOptionsException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidDomainValidationOptionsException' + '482': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + '483': + description: InvalidTagException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidTagException' + '484': + description: TooManyTagsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyTagsException' + '485': + description: TagPolicyException + content: + application/json: + schema: + $ref: '#/components/schemas/TagPolicyException' + '486': + description: InvalidParameterException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidParameterException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/RequestCertificateRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.RequestCertificate + 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' + /#X-Amz-Target=CertificateManager.ResendValidationEmail: + post: + operationId: ResendValidationEmail + description: 'Resends the email that requests domain ownership validation. The domain owner or an authorized representative must approve the ACM certificate before it can be issued. The certificate can be approved by clicking a link in the mail to navigate to the Amazon certificate approval website and then clicking I Approve. However, the validation email can be blocked by spam filters. Therefore, if you do not receive the original mail, you can request that the mail be resent within 72 hours of requesting the ACM certificate. If more than 72 hours have elapsed since your original request or since your last attempt to resend validation mail, you must request a new certificate. For more information about setting up your contact email addresses, see Configure Email for your Domain. ' + responses: + '200': + description: Success + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: InvalidStateException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidStateException' + '482': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + '483': + description: InvalidDomainValidationOptionsException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidDomainValidationOptionsException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/ResendValidationEmailRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.ResendValidationEmail + 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' + /#X-Amz-Target=CertificateManager.UpdateCertificateOptions: + post: + operationId: UpdateCertificateOptions + description: 'Updates a certificate. Currently, you can use this function to specify whether to opt in to or out of recording your certificate in a certificate transparency log. For more information, see Opting Out of Certificate Transparency Logging. ' + responses: + '200': + description: Success + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: LimitExceededException + content: + application/json: + schema: + $ref: '#/components/schemas/LimitExceededException' + '482': + description: InvalidStateException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidStateException' + '483': + description: InvalidArnException + content: + application/json: + schema: + $ref: '#/components/schemas/InvalidArnException' + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateCertificateOptionsRequest' + parameters: + - name: X-Amz-Target + in: header + required: true + schema: + type: string + enum: + - CertificateManager.UpdateCertificateOptions + 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' +components: + parameters: + X-Amz-Content-Sha256: + name: X-Amz-Content-Sha256 + in: header + schema: + type: string + required: false + X-Amz-Date: + name: X-Amz-Date + in: header + schema: + type: string + required: false + X-Amz-Algorithm: + name: X-Amz-Algorithm + in: header + schema: + type: string + required: false + X-Amz-Credential: + name: X-Amz-Credential + in: header + schema: + type: string + required: false + X-Amz-Security-Token: + name: X-Amz-Security-Token + in: header + schema: + type: string + required: false + X-Amz-Signature: + name: X-Amz-Signature + in: header + schema: + type: string + required: false + X-Amz-SignedHeaders: + name: X-Amz-SignedHeaders + in: header + schema: + type: string + required: false + securitySchemes: + hmac: + type: apiKey + name: Authorization + in: header + description: Amazon Signature authorization v4 + x-amazon-apigateway-authtype: awsSigv4 + schemas: + AddTagsToCertificateRequest: + type: object + required: + - CertificateArn + - Tags + title: AddTagsToCertificateRequest + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'String that contains the ARN of the ACM certificate to which the tag is to be applied. This must be of the form:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + Tags: + allOf: + - $ref: '#/components/schemas/TagList' + - description: The key-value pair that defines the tag. The tag value is optional. + ResourceNotFoundException: {} + InvalidArnException: {} + InvalidTagException: {} + TooManyTagsException: {} + TagPolicyException: {} + InvalidParameterException: {} + ThrottlingException: {} + DeleteCertificateRequest: + type: object + required: + - CertificateArn + title: DeleteCertificateRequest + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'String that contains the ARN of the ACM certificate to be deleted. This must be of the form:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + ResourceInUseException: {} + DescribeCertificateResponse: + type: object + properties: + Certificate: + allOf: + - $ref: '#/components/schemas/CertificateDetail' + - description: Metadata about an ACM certificate. + DescribeCertificateRequest: + type: object + required: + - CertificateArn + title: DescribeCertificateRequest + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'The Amazon Resource Name (ARN) of the ACM certificate. The ARN must have the following form:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + ExportCertificateResponse: + type: object + properties: + Certificate: + allOf: + - $ref: '#/components/schemas/CertificateBody' + - description: The base64 PEM-encoded certificate. + CertificateChain: + allOf: + - $ref: '#/components/schemas/CertificateChain' + - description: The base64 PEM-encoded certificate chain. This does not include the certificate that you are exporting. + PrivateKey: + allOf: + - $ref: '#/components/schemas/PrivateKey' + - description: 'The encrypted private key associated with the public key in the certificate. The key is output in PKCS #8 format and is base64 PEM-encoded. ' + ExportCertificateRequest: + type: object + required: + - CertificateArn + - Passphrase + title: ExportCertificateRequest + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'An Amazon Resource Name (ARN) of the issued certificate. This must be of the form:
arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012
Passphrase to associate with the encrypted exported private key. If you want to later decrypt the private key, you must have the passphrase. You can use the following OpenSSL command to decrypt a private key:
openssl rsa -in encrypted_key.pem -out decrypted_key.pem
String that contains a certificate ARN in the following format:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + ImportCertificateResponse: + type: object + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'The Amazon Resource Name (ARN) of the imported certificate.' + ImportCertificateRequest: + type: object + required: + - Certificate + - PrivateKey + title: ImportCertificateRequest + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'The Amazon Resource Name (ARN) of an imported certificate to replace. To import a new certificate, omit this field. ' + Certificate: + allOf: + - $ref: '#/components/schemas/CertificateBodyBlob' + - description: The certificate to import. + PrivateKey: + allOf: + - $ref: '#/components/schemas/PrivateKeyBlob' + - description: The private key that matches the public key in the certificate. + CertificateChain: + allOf: + - $ref: '#/components/schemas/CertificateChainBlob' + - description: The PEM encoded certificate chain. + Tags: + allOf: + - $ref: '#/components/schemas/TagList' + - description: 'One or more resource tags to associate with the imported certificate.
Note: You cannot apply tags when reimporting a certificate.
' + LimitExceededException: {} + ListCertificatesResponse: + type: object + properties: + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - description: 'When the list is truncated, this value is present and contains the value to use for theNextToken parameter in a subsequent pagination request.'
+ CertificateSummaryList:
+ allOf:
+ - $ref: '#/components/schemas/CertificateSummaryList'
+ - description: A list of ACM certificates.
+ ListCertificatesRequest:
+ type: object
+ title: ListCertificatesRequest
+ properties:
+ CertificateStatuses:
+ allOf:
+ - $ref: '#/components/schemas/CertificateStatuses'
+ - description: Filter the certificate list by status value.
+ Includes:
+ allOf:
+ - $ref: '#/components/schemas/Filters'
+ - description: 'Filter the certificate list. For more information, see the Filters structure.'
+ NextToken:
+ allOf:
+ - $ref: '#/components/schemas/NextToken'
+ - description: Use this parameter only when paginating results and only in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.
+ MaxItems:
+ allOf:
+ - $ref: '#/components/schemas/MaxItems'
+ - description: 'Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.'
+ InvalidArgsException: {}
+ ListTagsForCertificateResponse:
+ type: object
+ properties:
+ Tags:
+ allOf:
+ - $ref: '#/components/schemas/TagList'
+ - description: The key-value pairs that define the applied tags.
+ ListTagsForCertificateRequest:
+ type: object
+ required:
+ - CertificateArn
+ title: ListTagsForCertificateRequest
+ properties:
+ CertificateArn:
+ allOf:
+ - $ref: '#/components/schemas/Arn'
+ - description: 'String that contains the ARN of the ACM certificate for which you want to list the tags. This must have the following form:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + PutAccountConfigurationRequest: + type: object + required: + - IdempotencyToken + title: PutAccountConfigurationRequest + properties: + ExpiryEvents: + allOf: + - $ref: '#/components/schemas/ExpiryEventsConfiguration' + - description: Specifies expiration events associated with an account. + IdempotencyToken: + allOf: + - $ref: '#/components/schemas/IdempotencyToken' + - description: 'Customer-chosen string used to distinguish between calls toPutAccountConfiguration. Idempotency tokens time out after one hour. If you call PutAccountConfiguration multiple times with the same unexpired idempotency token, ACM treats it as the same request and returns the original result. If you change the idempotency token for each call, ACM treats each call as a new request.'
+ ValidationException: {}
+ ConflictException: {}
+ RemoveTagsFromCertificateRequest:
+ type: object
+ required:
+ - CertificateArn
+ - Tags
+ title: RemoveTagsFromCertificateRequest
+ properties:
+ CertificateArn:
+ allOf:
+ - $ref: '#/components/schemas/Arn'
+ - description: 'String that contains the ARN of the ACM Certificate with one or more tags that you want to remove. This must be of the form:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + Tags: + allOf: + - $ref: '#/components/schemas/TagList' + - description: The key-value pair that defines the tag to remove. + RenewCertificateRequest: + type: object + required: + - CertificateArn + title: RenewCertificateRequest + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'String that contains the ARN of the ACM certificate to be renewed. This must be of the form:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + RequestCertificateResponse: + type: object + properties: + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - description: 'String that contains the ARN of the issued certificate. This must be of the form:
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
Fully qualified domain name (FQDN), such as www.example.com, that you want to secure with an ACM certificate. Use an asterisk (*) to create a wildcard certificate that protects several sites in the same domain. For example, *.example.com protects www.example.com, site.example.com, and images.example.com.
The first domain name you enter cannot exceed 64 octets, including periods. Each subsequent Subject Alternative Name (SAN), however, can be up to 253 octets in length.
' + ValidationMethod: + allOf: + - $ref: '#/components/schemas/ValidationMethod' + - description: 'The method you want to use if you are requesting a public certificate to validate that you own or control domain. You can validate with DNS or validate with email. We recommend that you use DNS validation. ' + SubjectAlternativeNames: + allOf: + - $ref: '#/components/schemas/DomainList' + - description: 'Additional FQDNs to be included in the Subject Alternative Name extension of the ACM certificate. For example, add the name www.example.net to a certificate for which the DomainName field is www.example.com if users can reach your site by using either name. The maximum number of domain names that you can add to an ACM certificate is 100. However, the initial quota is 10 domain names. If you need more than 10 names, you must request a quota increase. For more information, see Quotas.
The maximum length of a SAN DNS name is 253 octets. The name is made up of multiple labels separated by periods. No label can be longer than 63 octets. Consider the following examples:
(63 octets).(63 octets).(63 octets).(61 octets) is legal because the total length is 253 octets (63+1+63+1+63+1+61) and no label exceeds 63 octets.
(64 octets).(63 octets).(63 octets).(61 octets) is not legal because the total length exceeds 253 octets (64+1+63+1+63+1+61) and the first label exceeds 63 octets.
(63 octets).(63 octets).(63 octets).(62 octets) is not legal because the total length of the DNS name (63+1+63+1+63+1+62) exceeds 253 octets.
RequestCertificate. Idempotency tokens time out after one hour. Therefore, if you call RequestCertificate multiple times with the same idempotency token within one hour, ACM recognizes that you are requesting only one certificate and will issue only one. If you change the idempotency token for each call, ACM recognizes that you are requesting multiple certificates.'
+ DomainValidationOptions:
+ allOf:
+ - $ref: '#/components/schemas/DomainValidationOptionList'
+ - description: The domain name that you want ACM to use to send you emails so that you can validate domain ownership.
+ Options:
+ allOf:
+ - $ref: '#/components/schemas/CertificateOptions'
+ - description: 'Currently, you can use this parameter to specify whether to add the certificate to a certificate transparency log. Certificate transparency makes it possible to detect SSL/TLS certificates that have been mistakenly or maliciously issued. Certificates that have not been logged typically produce an error message in a browser. For more information, see Opting Out of Certificate Transparency Logging.'
+ CertificateAuthorityArn:
+ allOf:
+ - $ref: '#/components/schemas/Arn'
+ - description: 'The Amazon Resource Name (ARN) of the private certificate authority (CA) that will be used to issue the certificate. If you do not provide an ARN and you are trying to request a private certificate, ACM will attempt to issue a public certificate. For more information about private CAs, see the AWS Certificate Manager Private Certificate Authority (PCA) user guide. The ARN must have the following form:
arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012
String that contains the ARN of the requested certificate. The certificate ARN is generated and returned by the RequestCertificate action as soon as the request is made. By default, using this parameter causes email to be sent to all top-level domains you specified in the certificate request. The ARN must be of the form:
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
The base validation domain that will act as the suffix of the email addresses that are used to send the emails. This must be the same as the Domain value or a superdomain of the Domain value. For example, if you requested a certificate for site.subdomain.example.com and specify a ValidationDomain of subdomain.example.com, ACM sends email to the domain registrant, technical contact, and administrative contact in WHOIS and the following five addresses:
admin@subdomain.example.com
administrator@subdomain.example.com
hostmaster@subdomain.example.com
postmaster@subdomain.example.com
webmaster@subdomain.example.com
ARN of the requested certificate to update. This must be of the form:
arn:aws:acm:us-east-1:account:certificate/12345678-1234-1234-1234-123456789012
AMAZON_ISSUED.'
+ RenewalStatusReason:
+ allOf:
+ - $ref: '#/components/schemas/FailureReason'
+ - description: The reason that a renewal request was unsuccessful.
+ UpdatedAt:
+ allOf:
+ - $ref: '#/components/schemas/TStamp'
+ - description: The time at which the renewal summary was last updated.
+ description: 'Contains information about the status of ACM''s managed renewal for the certificate. This structure exists only when the certificate type is AMAZON_ISSUED.'
+ KeyUsageList:
+ type: array
+ items:
+ $ref: '#/components/schemas/KeyUsage'
+ ExtendedKeyUsageList:
+ type: array
+ items:
+ $ref: '#/components/schemas/ExtendedKeyUsage'
+ RenewalEligibility:
+ type: string
+ enum:
+ - ELIGIBLE
+ - INELIGIBLE
+ CertificateOptions:
+ type: object
+ properties:
+ CertificateTransparencyLoggingPreference:
+ allOf:
+ - $ref: '#/components/schemas/CertificateTransparencyLoggingPreference'
+ - description: 'You can opt out of certificate transparency logging by specifying the DISABLED option. Opt in by specifying ENABLED. '
+ description: 'Structure that contains options for your certificate. Currently, you can use this only to specify whether to opt in to or out of certificate transparency logging. Some browsers require that public certificates issued for your domain be recorded in a log. Certificates that are not logged typically generate a browser error. Transparency makes it possible for you to detect SSL/TLS certificates that have been mistakenly or maliciously issued for your domain. For general information, see Certificate Transparency Logging. '
+ CertificateDetail:
+ type: object
+ properties:
+ CertificateArn:
+ allOf:
+ - $ref: '#/components/schemas/Arn'
+ - description: 'The Amazon Resource Name (ARN) of the certificate. For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference.'
+ DomainName:
+ allOf:
+ - $ref: '#/components/schemas/DomainNameString'
+ - description: 'The fully qualified domain name for the certificate, such as www.example.com or example.com.'
+ SubjectAlternativeNames:
+ allOf:
+ - $ref: '#/components/schemas/DomainList'
+ - description: 'One or more domain names (subject alternative names) included in the certificate. This list contains the domain names that are bound to the public key that is contained in the certificate. The subject alternative names include the canonical domain name (CN) of the certificate and additional domain names that can be used to connect to the website. '
+ DomainValidationOptions:
+ allOf:
+ - $ref: '#/components/schemas/DomainValidationList'
+ - description: 'Contains information about the initial validation of each domain name that occurs as a result of the RequestCertificate request. This field exists only when the certificate type is AMAZON_ISSUED. '
+ Serial:
+ allOf:
+ - $ref: '#/components/schemas/String'
+ - description: The serial number of the certificate.
+ Subject:
+ allOf:
+ - $ref: '#/components/schemas/String'
+ - description: The name of the entity that is associated with the public key contained in the certificate.
+ Issuer:
+ allOf:
+ - $ref: '#/components/schemas/String'
+ - description: The name of the certificate authority that issued and signed the certificate.
+ CreatedAt:
+ allOf:
+ - $ref: '#/components/schemas/TStamp'
+ - description: The time at which the certificate was requested.
+ IssuedAt:
+ allOf:
+ - $ref: '#/components/schemas/TStamp'
+ - description: 'The time at which the certificate was issued. This value exists only when the certificate type is AMAZON_ISSUED. '
+ ImportedAt:
+ allOf:
+ - $ref: '#/components/schemas/TStamp'
+ - description: 'The date and time at which the certificate was imported. This value exists only when the certificate type is IMPORTED. '
+ Status:
+ allOf:
+ - $ref: '#/components/schemas/CertificateStatus'
+ - description: The status of the certificate.
+ RevokedAt:
+ allOf:
+ - $ref: '#/components/schemas/TStamp'
+ - description: 'The time at which the certificate was revoked. This value exists only when the certificate status is REVOKED. '
+ RevocationReason:
+ allOf:
+ - $ref: '#/components/schemas/RevocationReason'
+ - description: 'The reason the certificate was revoked. This value exists only when the certificate status is REVOKED. '
+ NotBefore:
+ allOf:
+ - $ref: '#/components/schemas/TStamp'
+ - description: The time before which the certificate is not valid.
+ NotAfter:
+ allOf:
+ - $ref: '#/components/schemas/TStamp'
+ - description: The time after which the certificate is not valid.
+ KeyAlgorithm:
+ allOf:
+ - $ref: '#/components/schemas/KeyAlgorithm'
+ - description: The algorithm that was used to generate the public-private key pair.
+ SignatureAlgorithm:
+ allOf:
+ - $ref: '#/components/schemas/String'
+ - description: The algorithm that was used to sign the certificate.
+ InUseBy:
+ allOf:
+ - $ref: '#/components/schemas/InUseList'
+ - description: 'A list of ARNs for the AWS resources that are using the certificate. A certificate can be used by multiple AWS resources. '
+ FailureReason:
+ allOf:
+ - $ref: '#/components/schemas/FailureReason'
+ - description: 'The reason the certificate request failed. This value exists only when the certificate status is FAILED. For more information, see Certificate Request Failed in the AWS Certificate Manager User Guide. '
+ Type:
+ allOf:
+ - $ref: '#/components/schemas/CertificateType'
+ - description: 'The source of the certificate. For certificates provided by ACM, this value is AMAZON_ISSUED. For certificates that you imported with ImportCertificate, this value is IMPORTED. ACM does not provide managed renewal for imported certificates. For more information about the differences between certificates that you import and those that ACM provides, see Importing Certificates in the AWS Certificate Manager User Guide. '
+ RenewalSummary:
+ allOf:
+ - $ref: '#/components/schemas/RenewalSummary'
+ - description: 'Contains information about the status of ACM''s managed renewal for the certificate. This field exists only when the certificate type is AMAZON_ISSUED.'
+ KeyUsages:
+ allOf:
+ - $ref: '#/components/schemas/KeyUsageList'
+ - description: 'A list of Key Usage X.509 v3 extension objects. Each object is a string value that identifies the purpose of the public key contained in the certificate. Possible extension values include DIGITAL_SIGNATURE, KEY_ENCHIPHERMENT, NON_REPUDIATION, and more.'
+ ExtendedKeyUsages:
+ allOf:
+ - $ref: '#/components/schemas/ExtendedKeyUsageList'
+ - description: 'Contains a list of Extended Key Usage X.509 v3 extension objects. Each object specifies a purpose for which the certificate public key can be used and consists of a name and an object identifier (OID). '
+ CertificateAuthorityArn:
+ allOf:
+ - $ref: '#/components/schemas/Arn'
+ - description: 'The Amazon Resource Name (ARN) of the ACM PCA private certificate authority (CA) that issued the certificate. This has the following format:
arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012
Amazon Resource Name (ARN) of the certificate. This is of the form:
arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012
For more information about ARNs, see Amazon Resource Names (ARNs).
' + DomainName: + allOf: + - $ref: '#/components/schemas/DomainNameString' + - description: 'Fully qualified domain name (FQDN), such as www.example.com or example.com, for the certificate.' + description: 'This structure is returned in the response object of ListCertificates action. ' + CertificateSummaryList: + type: array + items: + $ref: '#/components/schemas/CertificateSummary' + DomainStatus: + type: string + enum: + - PENDING_VALIDATION + - SUCCESS + - FAILED + ValidationEmailList: + type: array + items: + $ref: '#/components/schemas/String' + ResourceRecord: + type: object + required: + - Name + - Type + - Value + properties: + Name: + allOf: + - $ref: '#/components/schemas/String' + - description: The name of the DNS record to create in your domain. This is supplied by ACM. + Type: + allOf: + - $ref: '#/components/schemas/RecordType' + - description: The type of DNS record. Currently this can beCNAME.
+ Value:
+ allOf:
+ - $ref: '#/components/schemas/String'
+ - description: The value of the CNAME record to add to your DNS database. This is supplied by ACM.
+ description: 'Contains a DNS record value that you can use to can use to validate ownership or control of a domain. This is used by the DescribeCertificate action. '
+ ValidationMethod:
+ type: string
+ enum:
+ - EMAIL
+ - DNS
+ DomainValidation:
+ type: object
+ required:
+ - DomainName
+ properties:
+ DomainName:
+ allOf:
+ - $ref: '#/components/schemas/DomainNameString'
+ - description: 'A fully qualified domain name (FQDN) in the certificate. For example, www.example.com or example.com. '
+ ValidationEmails:
+ allOf:
+ - $ref: '#/components/schemas/ValidationEmailList'
+ - description: A list of email addresses that ACM used to send domain validation emails.
+ ValidationDomain:
+ allOf:
+ - $ref: '#/components/schemas/DomainNameString'
+ - description: The domain name that ACM used to send domain validation emails.
+ ValidationStatus:
+ allOf:
+ - $ref: '#/components/schemas/DomainStatus'
+ - description: 'The validation status of the domain name. This can be one of the following values:
PENDING_VALIDATION
SUCCESS
FAILED
Contains the CNAME record that you add to your DNS database for domain validation. For more information, see Use DNS to Validate Domain Ownership.
Note: The CNAME information that you need does not include the name of your domain. If you include your domain name in the DNS database CNAME record, validation fails. For example, if the name is "_a79865eb4cd1a6ab990a45779b4e0b96.yourdomain.com", only "_a79865eb4cd1a6ab990a45779b4e0b96" must be used.
' + ValidationMethod: + allOf: + - $ref: '#/components/schemas/ValidationMethod' + - description: Specifies the domain validation method. + description: Contains information about the validation of each domain name in the certificate. + DomainValidationOption: + type: object + required: + - DomainName + - ValidationDomain + properties: + DomainName: + allOf: + - $ref: '#/components/schemas/DomainNameString' + - description: A fully qualified domain name (FQDN) in the certificate request. + ValidationDomain: + allOf: + - $ref: '#/components/schemas/DomainNameString' + - description: 'The domain name that you want ACM to use to send you validation emails. This domain name is the suffix of the email addresses that you want ACM to use. This must be the same as the DomainName value or a superdomain of the DomainName value. For example, if you request a certificate for testing.example.com, you can specify example.com for this value. In that case, ACM sends domain validation emails to the following five addresses:
admin@example.com
administrator@example.com
hostmaster@example.com
postmaster@example.com
webmaster@example.com
EventBridge events. ACM sends one event per day per certificate until the certificate expires. By default, accounts receive events starting 45 days before certificate expiration.'
+ description: Object containing expiration events options associated with an AWS account.
+ PassphraseBlob:
+ type: string
+ minLength: 4
+ maxLength: 128
+ format: password
+ PrivateKey:
+ type: string
+ pattern: '-{5}BEGIN PRIVATE KEY-{5}\u000D?\u000A([A-Za-z0-9/+]{64}\u000D?\u000A)*[A-Za-z0-9/+]{1,64}={0,2}\u000D?\u000A-{5}END PRIVATE KEY-{5}(\u000D?\u000A)?'
+ minLength: 1
+ maxLength: 524288
+ format: password
+ ExtendedKeyUsageName:
+ type: string
+ enum:
+ - TLS_WEB_SERVER_AUTHENTICATION
+ - TLS_WEB_CLIENT_AUTHENTICATION
+ - CODE_SIGNING
+ - EMAIL_PROTECTION
+ - TIME_STAMPING
+ - OCSP_SIGNING
+ - IPSEC_END_SYSTEM
+ - IPSEC_TUNNEL
+ - IPSEC_USER
+ - ANY
+ - NONE
+ - CUSTOM
+ ExtendedKeyUsage:
+ type: object
+ properties:
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/ExtendedKeyUsageName'
+ - description: The name of an Extended Key Usage value.
+ OID:
+ allOf:
+ - $ref: '#/components/schemas/String'
+ - description: An object identifier (OID) for the extension value. OIDs are strings of numbers separated by periods. The following OIDs are defined in RFC 3280 and RFC 5280.
1.3.6.1.5.5.7.3.1 (TLS_WEB_SERVER_AUTHENTICATION)
1.3.6.1.5.5.7.3.2 (TLS_WEB_CLIENT_AUTHENTICATION)
1.3.6.1.5.5.7.3.3 (CODE_SIGNING)
1.3.6.1.5.5.7.3.4 (EMAIL_PROTECTION)
1.3.6.1.5.5.7.3.8 (TIME_STAMPING)
1.3.6.1.5.5.7.3.9 (OCSP_SIGNING)
1.3.6.1.5.5.7.3.5 (IPSEC_END_SYSTEM)
1.3.6.1.5.5.7.3.6 (IPSEC_TUNNEL)
1.3.6.1.5.5.7.3.7 (IPSEC_USER)
Specify one or more algorithms that can be used to generate key pairs.
Default filtering returns only RSA_1024 and RSA_2048 certificates that have at least one domain. To return other certificate types, provide the desired type signatures in a comma-separated list. For example, "keyTypes": ["RSA_2048,RSA_4096"] returns both RSA_2048 and RSA_4096 certificates.
For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API integrations without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to the backend. The key should follow the pattern <action>:<header|querystring|path>.<location> where action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And512' + requestTemplates: + description: A mapping of identifier keys to templates. The value is an actual template script. The key is typically a SelectionKey which is chosen based on evaluating a selection expression. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween0And32K' + responseParameters: + description: Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. + type: object + additionalProperties: + $ref: '#/components/schemas/IntegrationParameters' + templateSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + timeoutInMillis: + description: 'An integer with a value between [50-30000].' + type: integer + minimum: 50 + maximum: 30000 + tlsConfig: + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + type: object + properties: + ServerNameToVerify: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And512' + - xml: + name: serverNameToVerify + description: 'If you specify a server name, API Gateway uses it to verify the hostname on the integration''s certificate. The server name is also included in the TLS handshake to support Server Name Indication (SNI) or virtual hosting.' + 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: GetIntegrations + description: Gets the Integrations for an API. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetIntegrationsResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: maxResults + in: query + required: false + description: The maximum number of elements to be returned for this resource. + schema: + type: string + - name: nextToken + in: query + required: false + description: The next page of elements from this collection. Not valid for the last element of the collection. + schema: + type: string + '/v2/apis/{apiId}/integrations/{integrationId}/integrationresponses': + post: + operationId: CreateIntegrationResponse + description: Creates an IntegrationResponses. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/CreateIntegrationResponseResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: integrationId + in: path + required: true + description: The integration ID. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - integrationResponseKey + properties: + contentHandlingStrategy: + description: Specifies how to handle response payload content type conversions. Supported only for WebSocket APIs. + type: string + enum: + - CONVERT_TO_BINARY + - CONVERT_TO_TEXT + integrationResponseKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + responseParameters: + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API integrations without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to the backend. The key should follow the pattern <action>:<header|querystring|path>.<location> where action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And512' + responseTemplates: + description: A mapping of identifier keys to templates. The value is an actual template script. The key is typically a SelectionKey which is chosen based on evaluating a selection expression. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween0And32K' + templateSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + 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: GetIntegrationResponses + description: Gets the IntegrationResponses for an Integration. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetIntegrationResponsesResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: integrationId + in: path + required: true + description: The integration ID. + schema: + type: string + - name: maxResults + in: query + required: false + description: The maximum number of elements to be returned for this resource. + schema: + type: string + - name: nextToken + in: query + required: false + description: The next page of elements from this collection. Not valid for the last element of the collection. + schema: + type: string + '/v2/apis/{apiId}/models': + post: + operationId: CreateModel + description: Creates a Model for an API. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/CreateModelResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - name + - schema + properties: + contentType: + description: 'A string with a length between [1-256].' + type: string + description: + description: 'A string with a length between [0-1024].' + type: string + name: + description: 'A string with a length between [1-128].' + type: string + schema: + description: 'A string with a length between [0-32768].' + type: string + 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: GetModels + description: Gets the Models for an API. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetModelsResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: maxResults + in: query + required: false + description: The maximum number of elements to be returned for this resource. + schema: + type: string + - name: nextToken + in: query + required: false + description: The next page of elements from this collection. Not valid for the last element of the collection. + schema: + type: string + '/v2/apis/{apiId}/routes': + post: + operationId: CreateRoute + description: Creates a Route for an API. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/CreateRouteResult' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - routeKey + properties: + apiKeyRequired: + description: Specifies whether an API key is required for the route. Supported only for WebSocket APIs. + type: boolean + authorizationScopes: + description: 'A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.' + type: array + items: + $ref: '#/components/schemas/StringWithLengthBetween1And64' + authorizationType: + description: 'The authorization type. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer. For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + type: string + enum: + - NONE + - AWS_IAM + - CUSTOM + - JWT + authorizerId: + description: The identifier. + type: string + modelSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + operationName: + description: 'A string with a length between [1-64].' + type: string + requestModels: + description: The route models. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And128' + requestParameters: + description: The route parameters. + type: object + additionalProperties: + $ref: '#/components/schemas/ParameterConstraints' + routeKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + routeResponseSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + target: + description: 'A string with a length between [1-128].' + type: string + 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: GetRoutes + description: Gets the Routes for an API. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetRoutesResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: maxResults + in: query + required: false + description: The maximum number of elements to be returned for this resource. + schema: + type: string + - name: nextToken + in: query + required: false + description: The next page of elements from this collection. Not valid for the last element of the collection. + schema: + type: string + '/v2/apis/{apiId}/routes/{routeId}/routeresponses': + post: + operationId: CreateRouteResponse + description: Creates a RouteResponse for a Route. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/CreateRouteResponseResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - routeResponseKey + properties: + modelSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + responseModels: + description: The route models. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And128' + responseParameters: + description: The route parameters. + type: object + additionalProperties: + $ref: '#/components/schemas/ParameterConstraints' + routeResponseKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + 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: GetRouteResponses + description: Gets the RouteResponses for a Route. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetRouteResponsesResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: maxResults + in: query + required: false + description: The maximum number of elements to be returned for this resource. + schema: + type: string + - name: nextToken + in: query + required: false + description: The next page of elements from this collection. Not valid for the last element of the collection. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + '/v2/apis/{apiId}/stages': + post: + operationId: CreateStage + description: Creates a Stage for an API. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/CreateStageResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - stageName + properties: + accessLogSettings: + description: Settings for logging access in a stage. + type: object + properties: + DestinationArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: destinationArn + description: The ARN of the CloudWatch Logs log group to receive access logs. + Format: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: format + description: 'A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.' + autoDeploy: + description: Specifies whether updates to an API automatically trigger a new deployment. The default value is false. + type: boolean + clientCertificateId: + description: The identifier. + type: string + defaultRouteSettings: + description: Represents a collection of route settings. + type: object + properties: + DataTraceEnabled: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: dataTraceEnabled + description: Specifies whether (true) or not (false) data trace logging is enabled for this route. This property affects the log entries pushed to Amazon CloudWatch Logs. Supported only for WebSocket APIs. + DetailedMetricsEnabled: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: detailedMetricsEnabled + description: Specifies whether detailed metrics are enabled. + LoggingLevel: + allOf: + - $ref: '#/components/schemas/LoggingLevel' + - xml: + name: loggingLevel + description: 'Specifies the logging level for this route: INFO, ERROR, or OFF. This property affects the log entries pushed to Amazon CloudWatch Logs. Supported only for WebSocket APIs.' + ThrottlingBurstLimit: + allOf: + - $ref: '#/components/schemas/__integer' + - xml: + name: throttlingBurstLimit + description: Specifies the throttling burst limit. + ThrottlingRateLimit: + allOf: + - $ref: '#/components/schemas/__double' + - xml: + name: throttlingRateLimit + description: Specifies the throttling rate limit. + deploymentId: + description: The identifier. + type: string + description: + description: 'A string with a length between [0-1024].' + type: string + routeSettings: + description: The route settings map. + type: object + additionalProperties: + $ref: '#/components/schemas/RouteSettings' + stageName: + description: 'A string with a length between [1-128].' + type: string + stageVariables: + description: The stage variable map. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween0And2048' + tags: + description: Represents a collection of tags associated with the resource. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And1600' + 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: GetStages + description: Gets the Stages for an API. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetStagesResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: maxResults + in: query + required: false + description: The maximum number of elements to be returned for this resource. + schema: + type: string + - name: nextToken + in: query + required: false + description: The next page of elements from this collection. Not valid for the last element of the collection. + schema: + type: string + /v2/vpclinks: + post: + operationId: CreateVpcLink + description: Creates a VPC link. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/CreateVpcLinkResponse' + '480': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: [] + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - name + - subnetIds + properties: + name: + description: 'A string with a length between [1-128].' + type: string + securityGroupIds: + description: A list of security group IDs for the VPC link. + type: array + items: + $ref: '#/components/schemas/__string' + subnetIds: + description: A list of subnet IDs to include in the VPC link. + type: array + items: + $ref: '#/components/schemas/__string' + tags: + description: Represents a collection of tags associated with the resource. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And1600' + 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: GetVpcLinks + description: Gets a collection of VPC links. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetVpcLinksResponse' + '480': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: maxResults + in: query + required: false + description: The maximum number of elements to be returned for this resource. + schema: + type: string + - name: nextToken + in: query + required: false + description: The next page of elements from this collection. Not valid for the last element of the collection. + schema: + type: string + '/v2/apis/{apiId}/stages/{stageName}/accesslogsettings': + delete: + operationId: DeleteAccessLogSettings + description: 'Deletes the AccessLogSettings for a Stage. To disable access logging for a Stage, delete its AccessLogSettings.' + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: stageName + in: path + required: true + description: 'The stage name. Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.' + schema: + type: string + 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' + '/v2/apis/{apiId}': + delete: + operationId: DeleteApi + description: Deletes an Api resource. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + 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: GetApi + description: Gets an Api resource. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetApiResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + put: + operationId: ReimportApi + description: Puts an Api resource. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/ReimportApiResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: basepath + in: query + required: false + description: 'Specifies how to interpret the base path of the API during import. Valid values are ignore, prepend, and split. The default value is ignore. To learn more, see Set the OpenAPI basePath Property. Supported only for HTTP APIs.' + schema: + type: string + - name: failOnWarnings + in: query + required: false + description: 'Specifies whether to rollback the API creation when a warning is encountered. By default, API creation continues if a warning is encountered.' + schema: + type: boolean + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - body + properties: + body: + description: The OpenAPI definition. Supported only for HTTP APIs. + type: string + patch: + operationId: UpdateApi + description: Updates an Api resource. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateApiResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + apiKeySelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + corsConfiguration: + description: 'Represents a CORS configuration. Supported only for HTTP APIs. See Configuring CORS for more information.' + type: object + properties: + AllowCredentials: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: allowCredentials + description: Specifies whether credentials are included in the CORS request. Supported only for HTTP APIs. + AllowHeaders: + allOf: + - $ref: '#/components/schemas/CorsHeaderList' + - xml: + name: allowHeaders + description: Represents a collection of allowed headers. Supported only for HTTP APIs. + AllowMethods: + allOf: + - $ref: '#/components/schemas/CorsMethodList' + - xml: + name: allowMethods + description: Represents a collection of allowed HTTP methods. Supported only for HTTP APIs. + AllowOrigins: + allOf: + - $ref: '#/components/schemas/CorsOriginList' + - xml: + name: allowOrigins + description: Represents a collection of allowed origins. Supported only for HTTP APIs. + ExposeHeaders: + allOf: + - $ref: '#/components/schemas/CorsHeaderList' + - xml: + name: exposeHeaders + description: Represents a collection of exposed headers. Supported only for HTTP APIs. + MaxAge: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetweenMinus1And86400' + - xml: + name: maxAge + description: The number of seconds that the browser should cache preflight request results. Supported only for HTTP APIs. + credentialsArn: + description: Represents an Amazon Resource Name (ARN). + type: string + description: + description: 'A string with a length between [0-1024].' + type: string + disableSchemaValidation: + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + type: boolean + disableExecuteApiEndpoint: + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + type: boolean + name: + description: 'A string with a length between [1-128].' + type: string + routeKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + routeSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + target: + description: 'A string representation of a URI with a length between [1-2048].' + type: string + version: + description: 'A string with a length between [1-64].' + type: string + '/v2/domainnames/{domainName}/apimappings/{apiMappingId}': + delete: + operationId: DeleteApiMapping + description: Deletes an API mapping. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiMappingId + in: path + required: true + description: The API mapping identifier. + schema: + type: string + - name: domainName + in: path + required: true + description: The domain name. + schema: + type: string + 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: GetApiMapping + description: Gets an API mapping. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetApiMappingResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiMappingId + in: path + required: true + description: The API mapping identifier. + schema: + type: string + - name: domainName + in: path + required: true + description: The domain name. + schema: + type: string + patch: + operationId: UpdateApiMapping + description: The API mapping. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateApiMappingResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiMappingId + in: path + required: true + description: The API mapping identifier. + schema: + type: string + - name: domainName + in: path + required: true + description: The domain name. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - apiId + properties: + apiId: + description: The identifier. + type: string + apiMappingKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + stage: + description: 'A string with a length between [1-128].' + type: string + '/v2/apis/{apiId}/authorizers/{authorizerId}': + delete: + operationId: DeleteAuthorizer + description: Deletes an Authorizer. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: authorizerId + in: path + required: true + description: The authorizer identifier. + schema: + type: string + 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: GetAuthorizer + description: Gets an Authorizer. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetAuthorizerResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: authorizerId + in: path + required: true + description: The authorizer identifier. + schema: + type: string + patch: + operationId: UpdateAuthorizer + description: Updates an Authorizer. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateAuthorizerResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: authorizerId + in: path + required: true + description: The authorizer identifier. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + authorizerCredentialsArn: + description: Represents an Amazon Resource Name (ARN). + type: string + authorizerPayloadFormatVersion: + description: 'A string with a length between [1-64].' + type: string + authorizerResultTtlInSeconds: + description: 'An integer with a value between [0-3600].' + type: integer + minimum: 0 + maximum: 3600 + authorizerType: + description: The authorizer type. Specify REQUEST for a Lambda function using incoming request parameters. Specify JWT to use JSON Web Tokens (supported only for HTTP APIs). + type: string + enum: + - REQUEST + - JWT + authorizerUri: + description: 'A string representation of a URI with a length between [1-2048].' + type: string + enableSimpleResponses: + description: 'Specifies whether a Lambda authorizer returns a response in a simple format. By default, a Lambda authorizer must return an IAM policy. If enabled, the Lambda authorizer can return a boolean value instead of an IAM policy. Supported only for HTTP APIs. To learn more, see Working with AWS Lambda authorizers for HTTP APIs' + type: boolean + identitySource: + description: 'The identity source for which authorization is requested. For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header, a Name query string parameter are defined as identity sources, this value is $method.request.header.Auth, $method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.' + type: array + items: + $ref: '#/components/schemas/__string' + identityValidationExpression: + description: 'A string with a length between [0-1024].' + type: string + jwtConfiguration: + description: Represents the configuration of a JWT authorizer. Required for the JWT authorizer type. Supported only for HTTP APIs. + type: object + properties: + Audience: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: audience + description: 'A list of the intended recipients of the JWT. A valid JWT must provide an aud that matches at least one entry in this list. See RFC 7519. Supported only for HTTP APIs.' + Issuer: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: issuer + description: |- + The base domain of the identity provider that issues JSON Web Tokens. For example, an Amazon Cognito user pool has the following format: https://cognito-idp.For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API integrations without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to the backend. The key should follow the pattern <action>:<header|querystring|path>.<location> where action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And512' + requestTemplates: + description: A mapping of identifier keys to templates. The value is an actual template script. The key is typically a SelectionKey which is chosen based on evaluating a selection expression. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween0And32K' + responseParameters: + description: Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. + type: object + additionalProperties: + $ref: '#/components/schemas/IntegrationParameters' + templateSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + timeoutInMillis: + description: 'An integer with a value between [50-30000].' + type: integer + minimum: 50 + maximum: 30000 + tlsConfig: + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + type: object + properties: + ServerNameToVerify: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And512' + - xml: + name: serverNameToVerify + description: 'If you specify a server name, API Gateway uses it to verify the hostname on the integration''s certificate. The server name is also included in the TLS handshake to support Server Name Indication (SNI) or virtual hosting.' + '/v2/apis/{apiId}/integrations/{integrationId}/integrationresponses/{integrationResponseId}': + delete: + operationId: DeleteIntegrationResponse + description: Deletes an IntegrationResponses. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: integrationId + in: path + required: true + description: The integration ID. + schema: + type: string + - name: integrationResponseId + in: path + required: true + description: The integration response ID. + schema: + type: string + 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: GetIntegrationResponse + description: Gets an IntegrationResponses. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetIntegrationResponseResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: integrationId + in: path + required: true + description: The integration ID. + schema: + type: string + - name: integrationResponseId + in: path + required: true + description: The integration response ID. + schema: + type: string + patch: + operationId: UpdateIntegrationResponse + description: Updates an IntegrationResponses. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateIntegrationResponseResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: integrationId + in: path + required: true + description: The integration ID. + schema: + type: string + - name: integrationResponseId + in: path + required: true + description: The integration response ID. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + contentHandlingStrategy: + description: Specifies how to handle response payload content type conversions. Supported only for WebSocket APIs. + type: string + enum: + - CONVERT_TO_BINARY + - CONVERT_TO_TEXT + integrationResponseKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + responseParameters: + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API integrations without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to the backend. The key should follow the pattern <action>:<header|querystring|path>.<location> where action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And512' + responseTemplates: + description: A mapping of identifier keys to templates. The value is an actual template script. The key is typically a SelectionKey which is chosen based on evaluating a selection expression. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween0And32K' + templateSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + '/v2/apis/{apiId}/models/{modelId}': + delete: + operationId: DeleteModel + description: Deletes a Model. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: modelId + in: path + required: true + description: The model ID. + schema: + type: string + 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: GetModel + description: Gets a Model. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetModelResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: modelId + in: path + required: true + description: The model ID. + schema: + type: string + patch: + operationId: UpdateModel + description: Updates a Model. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateModelResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: modelId + in: path + required: true + description: The model ID. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + contentType: + description: 'A string with a length between [1-256].' + type: string + description: + description: 'A string with a length between [0-1024].' + type: string + name: + description: 'A string with a length between [1-128].' + type: string + schema: + description: 'A string with a length between [0-32768].' + type: string + '/v2/apis/{apiId}/routes/{routeId}': + delete: + operationId: DeleteRoute + description: Deletes a Route. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + 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: GetRoute + description: Gets a Route. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetRouteResult' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + patch: + operationId: UpdateRoute + description: Updates a Route. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateRouteResult' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + apiKeyRequired: + description: Specifies whether an API key is required for the route. Supported only for WebSocket APIs. + type: boolean + authorizationScopes: + description: 'A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.' + type: array + items: + $ref: '#/components/schemas/StringWithLengthBetween1And64' + authorizationType: + description: 'The authorization type. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer. For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + type: string + enum: + - NONE + - AWS_IAM + - CUSTOM + - JWT + authorizerId: + description: The identifier. + type: string + modelSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + operationName: + description: 'A string with a length between [1-64].' + type: string + requestModels: + description: The route models. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And128' + requestParameters: + description: The route parameters. + type: object + additionalProperties: + $ref: '#/components/schemas/ParameterConstraints' + routeKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + routeResponseSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + target: + description: 'A string with a length between [1-128].' + type: string + '/v2/apis/{apiId}/routes/{routeId}/requestparameters/{requestParameterKey}': + delete: + operationId: DeleteRouteRequestParameter + description: Deletes a route request parameter. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: requestParameterKey + in: path + required: true + description: The route request parameter key. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + 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' + '/v2/apis/{apiId}/routes/{routeId}/routeresponses/{routeResponseId}': + delete: + operationId: DeleteRouteResponse + description: Deletes a RouteResponse. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + - name: routeResponseId + in: path + required: true + description: The route response ID. + schema: + type: string + 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: GetRouteResponse + description: Gets a RouteResponse. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetRouteResponseResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + - name: routeResponseId + in: path + required: true + description: The route response ID. + schema: + type: string + patch: + operationId: UpdateRouteResponse + description: Updates a RouteResponse. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateRouteResponseResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeId + in: path + required: true + description: The route ID. + schema: + type: string + - name: routeResponseId + in: path + required: true + description: The route response ID. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + modelSelectionExpression: + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + type: string + responseModels: + description: The route models. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And128' + responseParameters: + description: The route parameters. + type: object + additionalProperties: + $ref: '#/components/schemas/ParameterConstraints' + routeResponseKey: + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + type: string + '/v2/apis/{apiId}/stages/{stageName}/routesettings/{routeKey}': + delete: + operationId: DeleteRouteSettings + description: Deletes the RouteSettings for a stage. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: routeKey + in: path + required: true + description: The route key. + schema: + type: string + - name: stageName + in: path + required: true + description: 'The stage name. Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.' + schema: + type: string + 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' + '/v2/apis/{apiId}/stages/{stageName}': + delete: + operationId: DeleteStage + description: Deletes a Stage. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: stageName + in: path + required: true + description: 'The stage name. Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.' + schema: + type: string + 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: GetStage + description: Gets a Stage. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetStageResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: stageName + in: path + required: true + description: 'The stage name. Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.' + schema: + type: string + patch: + operationId: UpdateStage + description: Updates a Stage. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateStageResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: stageName + in: path + required: true + description: 'The stage name. Stage names can contain only alphanumeric characters, hyphens, and underscores, or be $default. Maximum length is 128 characters.' + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + accessLogSettings: + description: Settings for logging access in a stage. + type: object + properties: + DestinationArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: destinationArn + description: The ARN of the CloudWatch Logs log group to receive access logs. + Format: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: format + description: 'A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.' + autoDeploy: + description: Specifies whether updates to an API automatically trigger a new deployment. The default value is false. + type: boolean + clientCertificateId: + description: The identifier. + type: string + defaultRouteSettings: + description: Represents a collection of route settings. + type: object + properties: + DataTraceEnabled: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: dataTraceEnabled + description: Specifies whether (true) or not (false) data trace logging is enabled for this route. This property affects the log entries pushed to Amazon CloudWatch Logs. Supported only for WebSocket APIs. + DetailedMetricsEnabled: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: detailedMetricsEnabled + description: Specifies whether detailed metrics are enabled. + LoggingLevel: + allOf: + - $ref: '#/components/schemas/LoggingLevel' + - xml: + name: loggingLevel + description: 'Specifies the logging level for this route: INFO, ERROR, or OFF. This property affects the log entries pushed to Amazon CloudWatch Logs. Supported only for WebSocket APIs.' + ThrottlingBurstLimit: + allOf: + - $ref: '#/components/schemas/__integer' + - xml: + name: throttlingBurstLimit + description: Specifies the throttling burst limit. + ThrottlingRateLimit: + allOf: + - $ref: '#/components/schemas/__double' + - xml: + name: throttlingRateLimit + description: Specifies the throttling rate limit. + deploymentId: + description: The identifier. + type: string + description: + description: 'A string with a length between [0-1024].' + type: string + routeSettings: + description: The route settings map. + type: object + additionalProperties: + $ref: '#/components/schemas/RouteSettings' + stageVariables: + description: The stage variable map. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween0And2048' + '/v2/vpclinks/{vpcLinkId}': + delete: + operationId: DeleteVpcLink + description: Deletes a VPC link. + responses: + '202': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteVpcLinkResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: vpcLinkId + in: path + required: true + description: The ID of the VPC link. + schema: + type: string + 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: GetVpcLink + description: Gets a VPC link. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetVpcLinkResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: vpcLinkId + in: path + required: true + description: The ID of the VPC link. + schema: + type: string + patch: + operationId: UpdateVpcLink + description: Updates a VPC link. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateVpcLinkResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: vpcLinkId + in: path + required: true + description: The ID of the VPC link. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + name: + description: 'A string with a length between [1-128].' + type: string + '/v2/apis/{apiId}/exports/{specification}#outputType': + get: + operationId: ExportApi + description: '' + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/ExportApiResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: exportVersion + in: query + required: false + description: 'The version of the API Gateway export algorithm. API Gateway uses the latest version by default. Currently, the only supported version is 1.0.' + schema: + type: string + - name: includeExtensions + in: query + required: false + description: 'Specifies whether to include API Gateway extensions in the exported API definition. API Gateway extensions are included by default.' + schema: + type: boolean + - name: outputType + in: query + required: true + description: The output type of the exported definition file. Valid values are JSON and YAML. + schema: + type: string + - name: specification + in: path + required: true + description: 'The version of the API specification to use. OAS30, for OpenAPI 3.0, is the only supported value.' + schema: + type: string + - name: stageName + in: query + required: false + description: 'The name of the API stage to export. If you don''t specify this property, a representation of the latest API configuration is exported.' + schema: + type: string + 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' + '/v2/apis/{apiId}/stages/{stageName}/cache/authorizers': + delete: + operationId: ResetAuthorizersCache + description: Resets all authorizer cache entries on a stage. Supported only for HTTP APIs. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: stageName + in: path + required: true + description: 'The stage name. Stage names can contain only alphanumeric characters, hyphens, and underscores, or be $default. Maximum length is 128 characters.' + schema: + type: string + 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' + '/v2/apis/{apiId}/models/{modelId}/template': + get: + operationId: GetModelTemplate + description: Gets a model template. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetModelTemplateResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + parameters: + - name: apiId + in: path + required: true + description: The API identifier. + schema: + type: string + - name: modelId + in: path + required: true + description: The model ID. + schema: + type: string + 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' + '/v2/tags/{resource-arn}': + get: + operationId: GetTags + description: Gets a collection of Tag resources. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/GetTagsResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: resource-arn + in: path + required: true + description: The resource ARN for the tag. + schema: + type: string + 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' + post: + operationId: TagResource + description: Creates a new Tag resource to represent a tag. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/TagResourceResponse' + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: resource-arn + in: path + required: true + description: The resource ARN for the tag. + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + tags: + description: Represents a collection of tags associated with the resource. + type: object + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And1600' + '/v2/tags/{resource-arn}#tagKeys': + delete: + operationId: UntagResource + description: Deletes a Tag. + responses: + '204': + description: Success + '480': + description: NotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/NotFoundException' + '481': + description: TooManyRequestsException + content: + application/json: + schema: + $ref: '#/components/schemas/TooManyRequestsException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '483': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + parameters: + - name: resource-arn + in: path + required: true + description: The resource ARN for the tag. + schema: + type: string + - name: tagKeys + in: query + required: true + description: The Tag keys to delete + schema: + type: array + items: + $ref: '#/components/schemas/__string' + 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' +components: + parameters: + X-Amz-Content-Sha256: + name: X-Amz-Content-Sha256 + in: header + schema: + type: string + required: false + X-Amz-Date: + name: X-Amz-Date + in: header + schema: + type: string + required: false + X-Amz-Algorithm: + name: X-Amz-Algorithm + in: header + schema: + type: string + required: false + X-Amz-Credential: + name: X-Amz-Credential + in: header + schema: + type: string + required: false + X-Amz-Security-Token: + name: X-Amz-Security-Token + in: header + schema: + type: string + required: false + X-Amz-Signature: + name: X-Amz-Signature + in: header + schema: + type: string + required: false + X-Amz-SignedHeaders: + name: X-Amz-SignedHeaders + in: header + schema: + type: string + required: false + securitySchemes: + hmac: + type: apiKey + name: Authorization + in: header + description: Amazon Signature authorization v4 + x-amazon-apigateway-authtype: awsSigv4 + schemas: + CreateApiResponse: + type: object + properties: + ApiEndpoint: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: apiEndpoint + description: 'The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.' + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it. + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API ID. + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: A CORS configuration. Supported only for HTTP APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the API was created. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + ImportInfo: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: importInfo + description: The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + ProtocolType: + allOf: + - $ref: '#/components/schemas/ProtocolType' + - xml: + name: protocolType + description: The API protocol. + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: A collection of tags associated with the API. + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + Warnings: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: warnings + description: The warning messages reported when failonwarnings is turned on during API import. + __boolean: + type: boolean + CorsHeaderList: + type: array + description: Represents a collection of allowed headers. Supported only for HTTP APIs. + items: + $ref: '#/components/schemas/__string' + CorsMethodList: + type: array + description: Represents a collection of methods. Supported only for HTTP APIs. + items: + $ref: '#/components/schemas/StringWithLengthBetween1And64' + CorsOriginList: + type: array + description: Represents a collection of origins. Supported only for HTTP APIs. + items: + $ref: '#/components/schemas/__string' + IntegerWithLengthBetweenMinus1And86400: + type: integer + description: An integer with a value between -1 and 86400. Supported only for HTTP APIs. + minimum: -1 + maximum: 86400 + StringWithLengthBetween1And1600: + type: string + description: 'A string with a length between [0-1600].' + NotFoundException: {} + TooManyRequestsException: {} + BadRequestException: {} + ConflictException: {} + CreateApiMappingResponse: + type: object + properties: + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API identifier. + ApiMappingId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiMappingId + description: The API mapping identifier. + ApiMappingKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: apiMappingKey + description: The API mapping key. + Stage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stage + description: The API stage. + CreateAuthorizerResponse: + type: object + properties: + AuthorizerCredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: authorizerCredentialsArn + description: 'Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, don''t specify this parameter. Supported only for REQUEST authorizers.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The authorizer identifier. + AuthorizerPayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: authorizerPayloadFormatVersion + description: 'Specifies the format of the payload sent to an HTTP API Lambda authorizer. Required for HTTP API Lambda authorizers. Supported values are 1.0 and 2.0. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.' + AuthorizerResultTtlInSeconds: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween0And3600' + - xml: + name: authorizerResultTtlInSeconds + description: 'The time to live (TTL) for cached authorizer results, in seconds. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway caches authorizer responses. The maximum value is 3600, or 1 hour. Supported only for HTTP API Lambda authorizers.' + AuthorizerType: + allOf: + - $ref: '#/components/schemas/AuthorizerType' + - xml: + name: authorizerType + description: The authorizer type. Specify REQUEST for a Lambda function using incoming request parameters. Specify JWT to use JSON Web Tokens (supported only for HTTP APIs). + AuthorizerUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: authorizerUri + description: |- + The authorizer's Uniform Resource Identifier (URI). For REQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:The identity source for which authorization is requested.
For a REQUEST authorizer, this is optional. The value is a set of one or more mapping expressions of the specified request parameters. The identity source can be headers, query string parameters, stage variables, and context parameters. For example, if an Auth header and a Name query string parameter are defined as identity sources, this value is route.request.header.Auth, route.request.querystring.Name for WebSocket APIs. For HTTP APIs, use selection expressions prefixed with $, for example, $request.header.Auth, $request.querystring.Name. These parameters are used to perform runtime validation for Lambda-based authorizers by verifying all of the identity-related request parameters are present in the request, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function. Otherwise, it returns a 401 Unauthorized response without calling the Lambda function. For HTTP APIs, identity sources are also used as the cache key when caching is enabled. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.
For JWT, a single entry that specifies where to extract the JSON Web Token (JWT) from inbound requests. Currently only header-based and query parameter-based selections are supported, for example $request.header.Authorization.
' + IdentityValidationExpression: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: identityValidationExpression + description: The validation expression does not apply to the REQUEST authorizer. + JwtConfiguration: + allOf: + - $ref: '#/components/schemas/JWTConfiguration' + - xml: + name: jwtConfiguration + description: Represents the configuration of a JWT authorizer. Required for the JWT authorizer type. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the authorizer. + __string: + type: string + __listOf__string: + type: array + items: + $ref: '#/components/schemas/__string' + UriWithLengthBetween1And2048: + type: string + description: 'A string representation of a URI with a length between [1-2048].' + CreateDeploymentResponse: + type: object + properties: + AutoDeployed: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeployed + description: Specifies whether a deployment was automatically released. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The date and time when the Deployment resource was created. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier for the deployment. + DeploymentStatus: + allOf: + - $ref: '#/components/schemas/DeploymentStatus' + - xml: + name: deploymentStatus + description: 'The status of the deployment: PENDING, FAILED, or SUCCEEDED.' + DeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: deploymentStatusMessage + description: May contain additional feedback on the status of an API deployment. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description for the deployment. + CreateDomainNameResponse: + type: object + properties: + ApiMappingSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiMappingSelectionExpression + description: The API mapping selection expression. + DomainName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And512' + - xml: + name: domainName + description: The name of the DomainName resource. + DomainNameConfigurations: + allOf: + - $ref: '#/components/schemas/DomainNameConfigurations' + - xml: + name: domainNameConfigurations + description: The domain name configurations. + MutualTlsAuthentication: + allOf: + - $ref: '#/components/schemas/MutualTlsAuthentication' + - xml: + name: mutualTlsAuthentication + description: The mutual TLS authentication configuration for a custom domain name. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags associated with a domain name. + DomainNameConfiguration: + type: object + properties: + ApiGatewayDomainName: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: apiGatewayDomainName + description: A domain name for the API. + CertificateArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: certificateArn + description: An AWS-managed certificate that will be used by the edge-optimized endpoint for this domain name. AWS Certificate Manager is the only supported source. + CertificateName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: certificateName + description: The user-friendly name of the certificate that will be used by the edge-optimized endpoint for this domain name. + CertificateUploadDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: certificateUploadDate + description: The timestamp when the certificate that was used by edge-optimized endpoint for this domain name was uploaded. + DomainNameStatus: + allOf: + - $ref: '#/components/schemas/DomainNameStatus' + - xml: + name: domainNameStatus + description: 'The status of the domain name migration. The valid values are AVAILABLE and UPDATING. If the status is UPDATING, the domain cannot be modified further until the existing operation is complete. If it is AVAILABLE, the domain can be updated.' + DomainNameStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: domainNameStatusMessage + description: An optional text message containing detailed information about status of the domain name migration. + EndpointType: + allOf: + - $ref: '#/components/schemas/EndpointType' + - xml: + name: endpointType + description: The endpoint type. + HostedZoneId: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: hostedZoneId + description: The Amazon Route 53 Hosted Zone ID of the endpoint. + SecurityPolicy: + allOf: + - $ref: '#/components/schemas/SecurityPolicy' + - xml: + name: securityPolicy + description: The Transport Layer Security (TLS) version of the security policy for this domain name. The valid values are TLS_1_0 and TLS_1_2. + description: The domain name configuration. + StringWithLengthBetween1And64: + type: string + description: 'A string with a length between [1-64].' + AccessDeniedException: {} + CreateIntegrationResult: + type: object + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether an integration is managed by API Gateway. If you created an API using using quick create, the resulting integration is managed by API Gateway. You can update a managed integration, but you can''t delete it.' + ConnectionId: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: connectionId + description: The ID of the VPC link for a private integration. Supported only for HTTP APIs. + ConnectionType: + allOf: + - $ref: '#/components/schemas/ConnectionType' + - xml: + name: connectionType + description: The type of the network connection to the integration endpoint. Specify INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and resources in a VPC. The default value is INTERNET. + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: Represents the description of an integration. + IntegrationId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationId + description: Represents the identifier of an integration. + IntegrationMethod: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: integrationMethod + description: Specifies the integration's HTTP method type. + IntegrationResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: integrationResponseSelectionExpression + description: 'The integration response selection expression for the integration. Supported only for WebSocket APIs. See Integration Response Selection Expressions.' + IntegrationSubtype: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: integrationSubtype + description: 'Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke. To learn more, see Integration subtype reference.' + IntegrationType: + allOf: + - $ref: '#/components/schemas/IntegrationType' + - xml: + name: integrationType + description: 'The integration type of an integration. One of the following:
AWS: for integrating the route or method request with an AWS service action, including the Lambda function-invoking action. With the Lambda function-invoking action, this is referred to as the Lambda custom integration. With any other AWS service action, this is known as AWS integration. Supported only for WebSocket APIs.
AWS_PROXY: for integrating the route or method request with a Lambda function or other AWS service action. This integration is also referred to as a Lambda proxy integration.
HTTP: for integrating the route or method request with an HTTP endpoint. This integration is also referred to as the HTTP custom integration. Supported only for WebSocket APIs.
HTTP_PROXY: for integrating the route or method request with an HTTP endpoint, with the client request passed through as-is. This is also referred to as HTTP proxy integration.
MOCK: for integrating the route or method request with API Gateway as a "loopback" endpoint without invoking any backend. Supported only for WebSocket APIs.
' + IntegrationUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: integrationUri + description: 'For a Lambda integration, specify the URI of a Lambda function.
For an HTTP integration, specify a fully-qualified URL.
For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service. If you specify the ARN of an AWS Cloud Map service, API Gateway uses DiscoverInstances to identify resources. You can use query parameters to target specific resources. To learn more, see DiscoverInstances. For private integrations, all resources must be owned by the same AWS account.
' + PassthroughBehavior: + allOf: + - $ref: '#/components/schemas/PassthroughBehavior' + - xml: + name: passthroughBehavior + description: 'Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
WHEN_NO_MATCH passes the request body for unmapped content types through to the integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 Unsupported Media Type response.
WHEN_NO_TEMPLATES allows pass-through when the integration has no content types mapped to templates. However, if there is at least one content type defined, unmapped content types will be rejected with the same HTTP 415 Unsupported Media Type response.
' + PayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: payloadFormatVersion + description: Specifies the format of the payload sent to an integration. Required for HTTP APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: requestParameters + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API itegrations, without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to backend integrations. The key should follow the pattern <action>:<header|querystring|path>.<location>. The action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ RequestTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: requestTemplates + description: 'Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value. Supported only for WebSocket APIs.' + ResponseParameters: + allOf: + - $ref: '#/components/schemas/ResponseParameters' + - xml: + name: responseParameters + description: 'Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. Specify a key-value map from a selection key to response parameters. The selection key must be a valid HTTP status code within the range of 200-599. Response parameters are a key-value map. The key must match pattern <action>:<header>.<location> or overwrite.statuscode. The action can be append, overwrite or remove. The value can be a static value, or map to response data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expression for the integration. Supported only for WebSocket APIs. + TimeoutInMillis: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween50And30000' + - xml: + name: timeoutInMillis + description: 'Custom timeout between 50 and 29,000 milliseconds for WebSocket APIs and between 50 and 30,000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.' + TlsConfig: + allOf: + - $ref: '#/components/schemas/TlsConfig' + - xml: + name: tlsConfig + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + StringWithLengthBetween1And512: + type: string + description: 'A string with a length between [1-512].' + StringWithLengthBetween0And32K: + type: string + description: 'A string with a length between [0-32768].' + IntegrationParameters: + type: object + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API integrations without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to the backend. The key should follow the pattern <action>:<header|querystring|path>.<location> where action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And512' + CreateIntegrationResponseResponse: + type: object + properties: + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + IntegrationResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationResponseId + description: The integration response ID. + IntegrationResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: integrationResponseKey + description: The integration response key. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: responseParameters + description: 'A key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.{name}, where name is a valid and unique header name. The mapped non-static value must match the pattern of integration.response.header.{name} or integration.response.body.{JSON-expression}, where name is a valid and unique response header name and JSON-expression is a valid JSON expression without the $ prefix.' + ResponseTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: responseTemplates + description: 'The collection of response templates for the integration response as a string-to-string map of key-value pairs. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expressions for the integration response. + CreateModelResponse: + type: object + properties: + ContentType: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And256' + - xml: + name: contentType + description: 'The content-type for the model, for example, "application/json".' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the model. + ModelId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: modelId + description: The model identifier. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the model. Must be alphanumeric. + Schema: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And32K' + - xml: + name: schema + description: 'The schema for the model. For application/json models, this should be JSON schema draft 4 model.' + CreateRouteResult: + type: object + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a route is managed by API Gateway. If you created an API using quick create, the $default route is managed by API Gateway. You can''t modify the $default route key.' + ApiKeyRequired: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiKeyRequired + description: Specifies whether an API key is required for this route. Supported only for WebSocket APIs. + AuthorizationScopes: + allOf: + - $ref: '#/components/schemas/AuthorizationScopes' + - xml: + name: authorizationScopes + description: 'A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.' + AuthorizationType: + allOf: + - $ref: '#/components/schemas/AuthorizationType' + - xml: + name: authorizationType + description: 'The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer. + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: The model selection expression for the route. Supported only for WebSocket APIs. + OperationName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: operationName + description: The operation name for the route. + RequestModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: requestModels + description: The request models for the route. Supported only for WebSocket APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: requestParameters + description: The request parameters for the route. Supported only for WebSocket APIs. + RouteId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeId + description: The route ID. + RouteKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeKey + description: The route key for the route. + RouteResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeResponseSelectionExpression + description: The route response selection expression for the route. Supported only for WebSocket APIs. + Target: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: target + description: The target for the route. + StringWithLengthBetween1And128: + type: string + description: 'A string with a length between [1-128].' + ParameterConstraints: + type: object + properties: + Required: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: required + description: Whether or not the parameter is required. + description: 'Validation constraints imposed on parameters of a request (path, query string, headers).' + CreateRouteResponseResponse: + type: object + properties: + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: Represents the model selection expression of a route response. Supported only for WebSocket APIs. + ResponseModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: responseModels + description: Represents the response models of a route response. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: responseParameters + description: Represents the response parameters of a route response. + RouteResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeResponseId + description: Represents the identifier of a route response. + RouteResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeResponseKey + description: Represents the route response key of a route response. + CreateStageResponse: + type: object + properties: + AccessLogSettings: + allOf: + - $ref: '#/components/schemas/AccessLogSettings' + - xml: + name: accessLogSettings + description: Settings for logging access in this stage. + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can''t modify the $default stage.' + AutoDeploy: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeploy + description: Specifies whether updates to an API automatically trigger a new deployment. The default value is false. + ClientCertificateId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: clientCertificateId + description: The identifier of a client certificate for a Stage. Supported only for WebSocket APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the stage was created. + DefaultRouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettings' + - xml: + name: defaultRouteSettings + description: Default route settings for the stage. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the stage. + LastDeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: lastDeploymentStatusMessage + description: Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled. + LastUpdatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: lastUpdatedDate + description: The timestamp when the stage was last updated. + RouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettingsMap' + - xml: + name: routeSettings + description: 'Route settings for the stage, by routeKey.' + StageName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stageName + description: The name of the stage. + StageVariables: + allOf: + - $ref: '#/components/schemas/StageVariablesMap' + - xml: + name: stageVariables + description: 'A map that defines the stage variables for a stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags. Each tag element is associated with a given resource. + Arn: + type: string + description: Represents an Amazon Resource Name (ARN). + StringWithLengthBetween1And1024: + type: string + description: 'A string with a length between [1-1024].' + LoggingLevel: + type: string + enum: + - ERROR + - INFO + - 'OFF' + description: The logging level. + __integer: + type: integer + __double: + type: number + format: double + RouteSettings: + type: object + properties: + DataTraceEnabled: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: dataTraceEnabled + description: Specifies whether (true) or not (false) data trace logging is enabled for this route. This property affects the log entries pushed to Amazon CloudWatch Logs. Supported only for WebSocket APIs. + DetailedMetricsEnabled: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: detailedMetricsEnabled + description: Specifies whether detailed metrics are enabled. + LoggingLevel: + allOf: + - $ref: '#/components/schemas/LoggingLevel' + - xml: + name: loggingLevel + description: 'Specifies the logging level for this route: INFO, ERROR, or OFF. This property affects the log entries pushed to Amazon CloudWatch Logs. Supported only for WebSocket APIs.' + ThrottlingBurstLimit: + allOf: + - $ref: '#/components/schemas/__integer' + - xml: + name: throttlingBurstLimit + description: Specifies the throttling burst limit. + ThrottlingRateLimit: + allOf: + - $ref: '#/components/schemas/__double' + - xml: + name: throttlingRateLimit + description: Specifies the throttling rate limit. + description: Represents a collection of route settings. + StringWithLengthBetween0And2048: + type: string + description: 'A string with a length between [0-2048].' + CreateVpcLinkResponse: + type: object + properties: + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the VPC link was created. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the VPC link. + SecurityGroupIds: + allOf: + - $ref: '#/components/schemas/SecurityGroupIdList' + - xml: + name: securityGroupIds + description: A list of security group IDs for the VPC link. + SubnetIds: + allOf: + - $ref: '#/components/schemas/SubnetIdList' + - xml: + name: subnetIds + description: A list of subnet IDs to include in the VPC link. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: Tags for the VPC link. + VpcLinkId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: vpcLinkId + description: The ID of the VPC link. + VpcLinkStatus: + allOf: + - $ref: '#/components/schemas/VpcLinkStatus' + - xml: + name: vpcLinkStatus + description: The status of the VPC link. + VpcLinkStatusMessage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: vpcLinkStatusMessage + description: A message summarizing the cause of the status of the VPC link. + VpcLinkVersion: + allOf: + - $ref: '#/components/schemas/VpcLinkVersion' + - xml: + name: vpcLinkVersion + description: The version of the VPC link. + DeleteVpcLinkResponse: + type: object + properties: {} + ExportApiResponse: + type: object + properties: + body: + $ref: '#/components/schemas/ExportedApi' + GetApiResponse: + type: object + properties: + ApiEndpoint: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: apiEndpoint + description: 'The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.' + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it. + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API ID. + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: A CORS configuration. Supported only for HTTP APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the API was created. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + ImportInfo: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: importInfo + description: The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + ProtocolType: + allOf: + - $ref: '#/components/schemas/ProtocolType' + - xml: + name: protocolType + description: The API protocol. + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: A collection of tags associated with the API. + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + Warnings: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: warnings + description: The warning messages reported when failonwarnings is turned on during API import. + GetApiMappingResponse: + type: object + properties: + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API identifier. + ApiMappingId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiMappingId + description: The API mapping identifier. + ApiMappingKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: apiMappingKey + description: The API mapping key. + Stage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stage + description: The API stage. + GetApiMappingsResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfApiMapping' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetApisResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfApi' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetAuthorizerResponse: + type: object + properties: + AuthorizerCredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: authorizerCredentialsArn + description: 'Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, don''t specify this parameter. Supported only for REQUEST authorizers.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The authorizer identifier. + AuthorizerPayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: authorizerPayloadFormatVersion + description: 'Specifies the format of the payload sent to an HTTP API Lambda authorizer. Required for HTTP API Lambda authorizers. Supported values are 1.0 and 2.0. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.' + AuthorizerResultTtlInSeconds: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween0And3600' + - xml: + name: authorizerResultTtlInSeconds + description: 'The time to live (TTL) for cached authorizer results, in seconds. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway caches authorizer responses. The maximum value is 3600, or 1 hour. Supported only for HTTP API Lambda authorizers.' + AuthorizerType: + allOf: + - $ref: '#/components/schemas/AuthorizerType' + - xml: + name: authorizerType + description: The authorizer type. Specify REQUEST for a Lambda function using incoming request parameters. Specify JWT to use JSON Web Tokens (supported only for HTTP APIs). + AuthorizerUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: authorizerUri + description: |- + The authorizer's Uniform Resource Identifier (URI). For REQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:The identity source for which authorization is requested.
For a REQUEST authorizer, this is optional. The value is a set of one or more mapping expressions of the specified request parameters. The identity source can be headers, query string parameters, stage variables, and context parameters. For example, if an Auth header and a Name query string parameter are defined as identity sources, this value is route.request.header.Auth, route.request.querystring.Name for WebSocket APIs. For HTTP APIs, use selection expressions prefixed with $, for example, $request.header.Auth, $request.querystring.Name. These parameters are used to perform runtime validation for Lambda-based authorizers by verifying all of the identity-related request parameters are present in the request, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function. Otherwise, it returns a 401 Unauthorized response without calling the Lambda function. For HTTP APIs, identity sources are also used as the cache key when caching is enabled. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.
For JWT, a single entry that specifies where to extract the JSON Web Token (JWT) from inbound requests. Currently only header-based and query parameter-based selections are supported, for example $request.header.Authorization.
' + IdentityValidationExpression: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: identityValidationExpression + description: The validation expression does not apply to the REQUEST authorizer. + JwtConfiguration: + allOf: + - $ref: '#/components/schemas/JWTConfiguration' + - xml: + name: jwtConfiguration + description: Represents the configuration of a JWT authorizer. Required for the JWT authorizer type. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the authorizer. + GetAuthorizersResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfAuthorizer' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetDeploymentResponse: + type: object + properties: + AutoDeployed: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeployed + description: Specifies whether a deployment was automatically released. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The date and time when the Deployment resource was created. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier for the deployment. + DeploymentStatus: + allOf: + - $ref: '#/components/schemas/DeploymentStatus' + - xml: + name: deploymentStatus + description: 'The status of the deployment: PENDING, FAILED, or SUCCEEDED.' + DeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: deploymentStatusMessage + description: May contain additional feedback on the status of an API deployment. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description for the deployment. + GetDeploymentsResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfDeployment' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetDomainNameResponse: + type: object + properties: + ApiMappingSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiMappingSelectionExpression + description: The API mapping selection expression. + DomainName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And512' + - xml: + name: domainName + description: The name of the DomainName resource. + DomainNameConfigurations: + allOf: + - $ref: '#/components/schemas/DomainNameConfigurations' + - xml: + name: domainNameConfigurations + description: The domain name configurations. + MutualTlsAuthentication: + allOf: + - $ref: '#/components/schemas/MutualTlsAuthentication' + - xml: + name: mutualTlsAuthentication + description: The mutual TLS authentication configuration for a custom domain name. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags associated with a domain name. + GetDomainNamesResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfDomainName' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetIntegrationResult: + type: object + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether an integration is managed by API Gateway. If you created an API using using quick create, the resulting integration is managed by API Gateway. You can update a managed integration, but you can''t delete it.' + ConnectionId: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: connectionId + description: The ID of the VPC link for a private integration. Supported only for HTTP APIs. + ConnectionType: + allOf: + - $ref: '#/components/schemas/ConnectionType' + - xml: + name: connectionType + description: The type of the network connection to the integration endpoint. Specify INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and resources in a VPC. The default value is INTERNET. + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: Represents the description of an integration. + IntegrationId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationId + description: Represents the identifier of an integration. + IntegrationMethod: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: integrationMethod + description: Specifies the integration's HTTP method type. + IntegrationResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: integrationResponseSelectionExpression + description: 'The integration response selection expression for the integration. Supported only for WebSocket APIs. See Integration Response Selection Expressions.' + IntegrationSubtype: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: integrationSubtype + description: 'Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke. To learn more, see Integration subtype reference.' + IntegrationType: + allOf: + - $ref: '#/components/schemas/IntegrationType' + - xml: + name: integrationType + description: 'The integration type of an integration. One of the following:
AWS: for integrating the route or method request with an AWS service action, including the Lambda function-invoking action. With the Lambda function-invoking action, this is referred to as the Lambda custom integration. With any other AWS service action, this is known as AWS integration. Supported only for WebSocket APIs.
AWS_PROXY: for integrating the route or method request with a Lambda function or other AWS service action. This integration is also referred to as a Lambda proxy integration.
HTTP: for integrating the route or method request with an HTTP endpoint. This integration is also referred to as the HTTP custom integration. Supported only for WebSocket APIs.
HTTP_PROXY: for integrating the route or method request with an HTTP endpoint, with the client request passed through as-is. This is also referred to as HTTP proxy integration.
MOCK: for integrating the route or method request with API Gateway as a "loopback" endpoint without invoking any backend. Supported only for WebSocket APIs.
' + IntegrationUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: integrationUri + description: 'For a Lambda integration, specify the URI of a Lambda function.
For an HTTP integration, specify a fully-qualified URL.
For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service. If you specify the ARN of an AWS Cloud Map service, API Gateway uses DiscoverInstances to identify resources. You can use query parameters to target specific resources. To learn more, see DiscoverInstances. For private integrations, all resources must be owned by the same AWS account.
' + PassthroughBehavior: + allOf: + - $ref: '#/components/schemas/PassthroughBehavior' + - xml: + name: passthroughBehavior + description: 'Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
WHEN_NO_MATCH passes the request body for unmapped content types through to the integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 Unsupported Media Type response.
WHEN_NO_TEMPLATES allows pass-through when the integration has no content types mapped to templates. However, if there is at least one content type defined, unmapped content types will be rejected with the same HTTP 415 Unsupported Media Type response.
' + PayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: payloadFormatVersion + description: Specifies the format of the payload sent to an integration. Required for HTTP APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: requestParameters + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API itegrations, without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to backend integrations. The key should follow the pattern <action>:<header|querystring|path>.<location>. The action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ RequestTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: requestTemplates + description: 'Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value. Supported only for WebSocket APIs.' + ResponseParameters: + allOf: + - $ref: '#/components/schemas/ResponseParameters' + - xml: + name: responseParameters + description: 'Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. Specify a key-value map from a selection key to response parameters. The selection key must be a valid HTTP status code within the range of 200-599. Response parameters are a key-value map. The key must match pattern <action>:<header>.<location> or overwrite.statuscode. The action can be append, overwrite or remove. The value can be a static value, or map to response data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expression for the integration. Supported only for WebSocket APIs. + TimeoutInMillis: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween50And30000' + - xml: + name: timeoutInMillis + description: 'Custom timeout between 50 and 29,000 milliseconds for WebSocket APIs and between 50 and 30,000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.' + TlsConfig: + allOf: + - $ref: '#/components/schemas/TlsConfig' + - xml: + name: tlsConfig + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + GetIntegrationResponseResponse: + type: object + properties: + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + IntegrationResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationResponseId + description: The integration response ID. + IntegrationResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: integrationResponseKey + description: The integration response key. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: responseParameters + description: 'A key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.{name}, where name is a valid and unique header name. The mapped non-static value must match the pattern of integration.response.header.{name} or integration.response.body.{JSON-expression}, where name is a valid and unique response header name and JSON-expression is a valid JSON expression without the $ prefix.' + ResponseTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: responseTemplates + description: 'The collection of response templates for the integration response as a string-to-string map of key-value pairs. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expressions for the integration response. + GetIntegrationResponsesResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfIntegrationResponse' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetIntegrationsResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfIntegration' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetModelResponse: + type: object + properties: + ContentType: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And256' + - xml: + name: contentType + description: 'The content-type for the model, for example, "application/json".' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the model. + ModelId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: modelId + description: The model identifier. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the model. Must be alphanumeric. + Schema: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And32K' + - xml: + name: schema + description: 'The schema for the model. For application/json models, this should be JSON schema draft 4 model.' + GetModelTemplateResponse: + type: object + properties: + Value: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: value + description: The template value. + GetModelsResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfModel' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetRouteResult: + type: object + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a route is managed by API Gateway. If you created an API using quick create, the $default route is managed by API Gateway. You can''t modify the $default route key.' + ApiKeyRequired: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiKeyRequired + description: Specifies whether an API key is required for this route. Supported only for WebSocket APIs. + AuthorizationScopes: + allOf: + - $ref: '#/components/schemas/AuthorizationScopes' + - xml: + name: authorizationScopes + description: 'A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.' + AuthorizationType: + allOf: + - $ref: '#/components/schemas/AuthorizationType' + - xml: + name: authorizationType + description: 'The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer. + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: The model selection expression for the route. Supported only for WebSocket APIs. + OperationName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: operationName + description: The operation name for the route. + RequestModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: requestModels + description: The request models for the route. Supported only for WebSocket APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: requestParameters + description: The request parameters for the route. Supported only for WebSocket APIs. + RouteId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeId + description: The route ID. + RouteKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeKey + description: The route key for the route. + RouteResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeResponseSelectionExpression + description: The route response selection expression for the route. Supported only for WebSocket APIs. + Target: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: target + description: The target for the route. + GetRouteResponseResponse: + type: object + properties: + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: Represents the model selection expression of a route response. Supported only for WebSocket APIs. + ResponseModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: responseModels + description: Represents the response models of a route response. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: responseParameters + description: Represents the response parameters of a route response. + RouteResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeResponseId + description: Represents the identifier of a route response. + RouteResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeResponseKey + description: Represents the route response key of a route response. + GetRouteResponsesResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfRouteResponse' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetRoutesResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfRoute' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetStageResponse: + type: object + properties: + AccessLogSettings: + allOf: + - $ref: '#/components/schemas/AccessLogSettings' + - xml: + name: accessLogSettings + description: Settings for logging access in this stage. + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can''t modify the $default stage.' + AutoDeploy: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeploy + description: Specifies whether updates to an API automatically trigger a new deployment. The default value is false. + ClientCertificateId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: clientCertificateId + description: The identifier of a client certificate for a Stage. Supported only for WebSocket APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the stage was created. + DefaultRouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettings' + - xml: + name: defaultRouteSettings + description: Default route settings for the stage. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the stage. + LastDeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: lastDeploymentStatusMessage + description: Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled. + LastUpdatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: lastUpdatedDate + description: The timestamp when the stage was last updated. + RouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettingsMap' + - xml: + name: routeSettings + description: 'Route settings for the stage, by routeKey.' + StageName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stageName + description: The name of the stage. + StageVariables: + allOf: + - $ref: '#/components/schemas/StageVariablesMap' + - xml: + name: stageVariables + description: 'A map that defines the stage variables for a stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags. Each tag element is associated with a given resource. + GetStagesResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfStage' + - xml: + name: items + description: The elements from this collection. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetTagsResponse: + type: object + properties: + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + GetVpcLinkResponse: + type: object + properties: + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the VPC link was created. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the VPC link. + SecurityGroupIds: + allOf: + - $ref: '#/components/schemas/SecurityGroupIdList' + - xml: + name: securityGroupIds + description: A list of security group IDs for the VPC link. + SubnetIds: + allOf: + - $ref: '#/components/schemas/SubnetIdList' + - xml: + name: subnetIds + description: A list of subnet IDs to include in the VPC link. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: Tags for the VPC link. + VpcLinkId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: vpcLinkId + description: The ID of the VPC link. + VpcLinkStatus: + allOf: + - $ref: '#/components/schemas/VpcLinkStatus' + - xml: + name: vpcLinkStatus + description: The status of the VPC link. + VpcLinkStatusMessage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: vpcLinkStatusMessage + description: A message summarizing the cause of the status of the VPC link. + VpcLinkVersion: + allOf: + - $ref: '#/components/schemas/VpcLinkVersion' + - xml: + name: vpcLinkVersion + description: The version of the VPC link. + GetVpcLinksResponse: + type: object + properties: + Items: + allOf: + - $ref: '#/components/schemas/__listOfVpcLink' + - xml: + name: items + description: A collection of VPC links. + NextToken: + allOf: + - $ref: '#/components/schemas/NextToken' + - xml: + name: nextToken + description: The next page of elements from this collection. Not valid for the last element of the collection. + ImportApiResponse: + type: object + properties: + ApiEndpoint: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: apiEndpoint + description: 'The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.' + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it. + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API ID. + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: A CORS configuration. Supported only for HTTP APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the API was created. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + ImportInfo: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: importInfo + description: The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + ProtocolType: + allOf: + - $ref: '#/components/schemas/ProtocolType' + - xml: + name: protocolType + description: The API protocol. + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: A collection of tags associated with the API. + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + Warnings: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: warnings + description: The warning messages reported when failonwarnings is turned on during API import. + ReimportApiResponse: + type: object + properties: + ApiEndpoint: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: apiEndpoint + description: 'The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.' + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it. + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API ID. + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: A CORS configuration. Supported only for HTTP APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the API was created. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + ImportInfo: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: importInfo + description: The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + ProtocolType: + allOf: + - $ref: '#/components/schemas/ProtocolType' + - xml: + name: protocolType + description: The API protocol. + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: A collection of tags associated with the API. + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + Warnings: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: warnings + description: The warning messages reported when failonwarnings is turned on during API import. + TagResourceResponse: + type: object + properties: {} + UpdateApiResponse: + type: object + properties: + ApiEndpoint: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: apiEndpoint + description: 'The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.' + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it. + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API ID. + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: A CORS configuration. Supported only for HTTP APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the API was created. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + ImportInfo: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: importInfo + description: The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + ProtocolType: + allOf: + - $ref: '#/components/schemas/ProtocolType' + - xml: + name: protocolType + description: The API protocol. + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: A collection of tags associated with the API. + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + Warnings: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: warnings + description: The warning messages reported when failonwarnings is turned on during API import. + UpdateApiMappingResponse: + type: object + properties: + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API identifier. + ApiMappingId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiMappingId + description: The API mapping identifier. + ApiMappingKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: apiMappingKey + description: The API mapping key. + Stage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stage + description: The API stage. + UpdateAuthorizerResponse: + type: object + properties: + AuthorizerCredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: authorizerCredentialsArn + description: 'Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, don''t specify this parameter. Supported only for REQUEST authorizers.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The authorizer identifier. + AuthorizerPayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: authorizerPayloadFormatVersion + description: 'Specifies the format of the payload sent to an HTTP API Lambda authorizer. Required for HTTP API Lambda authorizers. Supported values are 1.0 and 2.0. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.' + AuthorizerResultTtlInSeconds: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween0And3600' + - xml: + name: authorizerResultTtlInSeconds + description: 'The time to live (TTL) for cached authorizer results, in seconds. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway caches authorizer responses. The maximum value is 3600, or 1 hour. Supported only for HTTP API Lambda authorizers.' + AuthorizerType: + allOf: + - $ref: '#/components/schemas/AuthorizerType' + - xml: + name: authorizerType + description: The authorizer type. Specify REQUEST for a Lambda function using incoming request parameters. Specify JWT to use JSON Web Tokens (supported only for HTTP APIs). + AuthorizerUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: authorizerUri + description: |- + The authorizer's Uniform Resource Identifier (URI). For REQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:The identity source for which authorization is requested.
For a REQUEST authorizer, this is optional. The value is a set of one or more mapping expressions of the specified request parameters. The identity source can be headers, query string parameters, stage variables, and context parameters. For example, if an Auth header and a Name query string parameter are defined as identity sources, this value is route.request.header.Auth, route.request.querystring.Name for WebSocket APIs. For HTTP APIs, use selection expressions prefixed with $, for example, $request.header.Auth, $request.querystring.Name. These parameters are used to perform runtime validation for Lambda-based authorizers by verifying all of the identity-related request parameters are present in the request, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function. Otherwise, it returns a 401 Unauthorized response without calling the Lambda function. For HTTP APIs, identity sources are also used as the cache key when caching is enabled. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.
For JWT, a single entry that specifies where to extract the JSON Web Token (JWT) from inbound requests. Currently only header-based and query parameter-based selections are supported, for example $request.header.Authorization.
' + IdentityValidationExpression: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: identityValidationExpression + description: The validation expression does not apply to the REQUEST authorizer. + JwtConfiguration: + allOf: + - $ref: '#/components/schemas/JWTConfiguration' + - xml: + name: jwtConfiguration + description: Represents the configuration of a JWT authorizer. Required for the JWT authorizer type. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the authorizer. + UpdateDeploymentResponse: + type: object + properties: + AutoDeployed: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeployed + description: Specifies whether a deployment was automatically released. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The date and time when the Deployment resource was created. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier for the deployment. + DeploymentStatus: + allOf: + - $ref: '#/components/schemas/DeploymentStatus' + - xml: + name: deploymentStatus + description: 'The status of the deployment: PENDING, FAILED, or SUCCEEDED.' + DeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: deploymentStatusMessage + description: May contain additional feedback on the status of an API deployment. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description for the deployment. + UpdateDomainNameResponse: + type: object + properties: + ApiMappingSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiMappingSelectionExpression + description: The API mapping selection expression. + DomainName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And512' + - xml: + name: domainName + description: The name of the DomainName resource. + DomainNameConfigurations: + allOf: + - $ref: '#/components/schemas/DomainNameConfigurations' + - xml: + name: domainNameConfigurations + description: The domain name configurations. + MutualTlsAuthentication: + allOf: + - $ref: '#/components/schemas/MutualTlsAuthentication' + - xml: + name: mutualTlsAuthentication + description: The mutual TLS authentication configuration for a custom domain name. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags associated with a domain name. + UpdateIntegrationResult: + type: object + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether an integration is managed by API Gateway. If you created an API using using quick create, the resulting integration is managed by API Gateway. You can update a managed integration, but you can''t delete it.' + ConnectionId: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: connectionId + description: The ID of the VPC link for a private integration. Supported only for HTTP APIs. + ConnectionType: + allOf: + - $ref: '#/components/schemas/ConnectionType' + - xml: + name: connectionType + description: The type of the network connection to the integration endpoint. Specify INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and resources in a VPC. The default value is INTERNET. + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: Represents the description of an integration. + IntegrationId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationId + description: Represents the identifier of an integration. + IntegrationMethod: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: integrationMethod + description: Specifies the integration's HTTP method type. + IntegrationResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: integrationResponseSelectionExpression + description: 'The integration response selection expression for the integration. Supported only for WebSocket APIs. See Integration Response Selection Expressions.' + IntegrationSubtype: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: integrationSubtype + description: 'Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke. To learn more, see Integration subtype reference.' + IntegrationType: + allOf: + - $ref: '#/components/schemas/IntegrationType' + - xml: + name: integrationType + description: 'The integration type of an integration. One of the following:
AWS: for integrating the route or method request with an AWS service action, including the Lambda function-invoking action. With the Lambda function-invoking action, this is referred to as the Lambda custom integration. With any other AWS service action, this is known as AWS integration. Supported only for WebSocket APIs.
AWS_PROXY: for integrating the route or method request with a Lambda function or other AWS service action. This integration is also referred to as a Lambda proxy integration.
HTTP: for integrating the route or method request with an HTTP endpoint. This integration is also referred to as the HTTP custom integration. Supported only for WebSocket APIs.
HTTP_PROXY: for integrating the route or method request with an HTTP endpoint, with the client request passed through as-is. This is also referred to as HTTP proxy integration.
MOCK: for integrating the route or method request with API Gateway as a "loopback" endpoint without invoking any backend. Supported only for WebSocket APIs.
' + IntegrationUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: integrationUri + description: 'For a Lambda integration, specify the URI of a Lambda function.
For an HTTP integration, specify a fully-qualified URL.
For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service. If you specify the ARN of an AWS Cloud Map service, API Gateway uses DiscoverInstances to identify resources. You can use query parameters to target specific resources. To learn more, see DiscoverInstances. For private integrations, all resources must be owned by the same AWS account.
' + PassthroughBehavior: + allOf: + - $ref: '#/components/schemas/PassthroughBehavior' + - xml: + name: passthroughBehavior + description: 'Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
WHEN_NO_MATCH passes the request body for unmapped content types through to the integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 Unsupported Media Type response.
WHEN_NO_TEMPLATES allows pass-through when the integration has no content types mapped to templates. However, if there is at least one content type defined, unmapped content types will be rejected with the same HTTP 415 Unsupported Media Type response.
' + PayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: payloadFormatVersion + description: Specifies the format of the payload sent to an integration. Required for HTTP APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: requestParameters + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API itegrations, without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to backend integrations. The key should follow the pattern <action>:<header|querystring|path>.<location>. The action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ RequestTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: requestTemplates + description: 'Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value. Supported only for WebSocket APIs.' + ResponseParameters: + allOf: + - $ref: '#/components/schemas/ResponseParameters' + - xml: + name: responseParameters + description: 'Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. Specify a key-value map from a selection key to response parameters. The selection key must be a valid HTTP status code within the range of 200-599. Response parameters are a key-value map. The key must match pattern <action>:<header>.<location> or overwrite.statuscode. The action can be append, overwrite or remove. The value can be a static value, or map to response data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expression for the integration. Supported only for WebSocket APIs. + TimeoutInMillis: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween50And30000' + - xml: + name: timeoutInMillis + description: 'Custom timeout between 50 and 29,000 milliseconds for WebSocket APIs and between 50 and 30,000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.' + TlsConfig: + allOf: + - $ref: '#/components/schemas/TlsConfig' + - xml: + name: tlsConfig + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + UpdateIntegrationResponseResponse: + type: object + properties: + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + IntegrationResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationResponseId + description: The integration response ID. + IntegrationResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: integrationResponseKey + description: The integration response key. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: responseParameters + description: 'A key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.{name}, where name is a valid and unique header name. The mapped non-static value must match the pattern of integration.response.header.{name} or integration.response.body.{JSON-expression}, where name is a valid and unique response header name and JSON-expression is a valid JSON expression without the $ prefix.' + ResponseTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: responseTemplates + description: 'The collection of response templates for the integration response as a string-to-string map of key-value pairs. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expressions for the integration response. + UpdateModelResponse: + type: object + properties: + ContentType: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And256' + - xml: + name: contentType + description: 'The content-type for the model, for example, "application/json".' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the model. + ModelId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: modelId + description: The model identifier. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the model. Must be alphanumeric. + Schema: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And32K' + - xml: + name: schema + description: 'The schema for the model. For application/json models, this should be JSON schema draft 4 model.' + UpdateRouteResult: + type: object + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a route is managed by API Gateway. If you created an API using quick create, the $default route is managed by API Gateway. You can''t modify the $default route key.' + ApiKeyRequired: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiKeyRequired + description: Specifies whether an API key is required for this route. Supported only for WebSocket APIs. + AuthorizationScopes: + allOf: + - $ref: '#/components/schemas/AuthorizationScopes' + - xml: + name: authorizationScopes + description: 'A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.' + AuthorizationType: + allOf: + - $ref: '#/components/schemas/AuthorizationType' + - xml: + name: authorizationType + description: 'The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer. + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: The model selection expression for the route. Supported only for WebSocket APIs. + OperationName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: operationName + description: The operation name for the route. + RequestModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: requestModels + description: The request models for the route. Supported only for WebSocket APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: requestParameters + description: The request parameters for the route. Supported only for WebSocket APIs. + RouteId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeId + description: The route ID. + RouteKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeKey + description: The route key for the route. + RouteResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeResponseSelectionExpression + description: The route response selection expression for the route. Supported only for WebSocket APIs. + Target: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: target + description: The target for the route. + UpdateRouteResponseResponse: + type: object + properties: + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: Represents the model selection expression of a route response. Supported only for WebSocket APIs. + ResponseModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: responseModels + description: Represents the response models of a route response. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: responseParameters + description: Represents the response parameters of a route response. + RouteResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeResponseId + description: Represents the identifier of a route response. + RouteResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeResponseKey + description: Represents the route response key of a route response. + UpdateStageResponse: + type: object + properties: + AccessLogSettings: + allOf: + - $ref: '#/components/schemas/AccessLogSettings' + - xml: + name: accessLogSettings + description: Settings for logging access in this stage. + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can''t modify the $default stage.' + AutoDeploy: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeploy + description: Specifies whether updates to an API automatically trigger a new deployment. The default value is false. + ClientCertificateId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: clientCertificateId + description: The identifier of a client certificate for a Stage. Supported only for WebSocket APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the stage was created. + DefaultRouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettings' + - xml: + name: defaultRouteSettings + description: Default route settings for the stage. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the stage. + LastDeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: lastDeploymentStatusMessage + description: Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled. + LastUpdatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: lastUpdatedDate + description: The timestamp when the stage was last updated. + RouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettingsMap' + - xml: + name: routeSettings + description: 'Route settings for the stage, by routeKey.' + StageName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stageName + description: The name of the stage. + StageVariables: + allOf: + - $ref: '#/components/schemas/StageVariablesMap' + - xml: + name: stageVariables + description: 'A map that defines the stage variables for a stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags. Each tag element is associated with a given resource. + UpdateVpcLinkResponse: + type: object + properties: + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the VPC link was created. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the VPC link. + SecurityGroupIds: + allOf: + - $ref: '#/components/schemas/SecurityGroupIdList' + - xml: + name: securityGroupIds + description: A list of security group IDs for the VPC link. + SubnetIds: + allOf: + - $ref: '#/components/schemas/SubnetIdList' + - xml: + name: subnetIds + description: A list of subnet IDs to include in the VPC link. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: Tags for the VPC link. + VpcLinkId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: vpcLinkId + description: The ID of the VPC link. + VpcLinkStatus: + allOf: + - $ref: '#/components/schemas/VpcLinkStatus' + - xml: + name: vpcLinkStatus + description: The status of the VPC link. + VpcLinkStatusMessage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: vpcLinkStatusMessage + description: A message summarizing the cause of the status of the VPC link. + VpcLinkVersion: + allOf: + - $ref: '#/components/schemas/VpcLinkVersion' + - xml: + name: vpcLinkVersion + description: The version of the VPC link. + AccessLogSettings: + type: object + properties: + DestinationArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: destinationArn + description: The ARN of the CloudWatch Logs log group to receive access logs. + Format: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: format + description: 'A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.' + description: Settings for logging access in a stage. + Id: + type: string + description: The identifier. + SelectionExpression: + type: string + description: 'An expression used to extract information at runtime. See Selection Expressions for more information.' + Cors: + type: object + properties: + AllowCredentials: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: allowCredentials + description: Specifies whether credentials are included in the CORS request. Supported only for HTTP APIs. + AllowHeaders: + allOf: + - $ref: '#/components/schemas/CorsHeaderList' + - xml: + name: allowHeaders + description: Represents a collection of allowed headers. Supported only for HTTP APIs. + AllowMethods: + allOf: + - $ref: '#/components/schemas/CorsMethodList' + - xml: + name: allowMethods + description: Represents a collection of allowed HTTP methods. Supported only for HTTP APIs. + AllowOrigins: + allOf: + - $ref: '#/components/schemas/CorsOriginList' + - xml: + name: allowOrigins + description: Represents a collection of allowed origins. Supported only for HTTP APIs. + ExposeHeaders: + allOf: + - $ref: '#/components/schemas/CorsHeaderList' + - xml: + name: exposeHeaders + description: Represents a collection of exposed headers. Supported only for HTTP APIs. + MaxAge: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetweenMinus1And86400' + - xml: + name: maxAge + description: The number of seconds that the browser should cache preflight request results. Supported only for HTTP APIs. + description: 'Represents a CORS configuration. Supported only for HTTP APIs. See Configuring CORS for more information.' + __timestampIso8601: + type: string + format: date-time + StringWithLengthBetween0And1024: + type: string + description: 'A string with a length between [0-1024].' + ProtocolType: + type: string + enum: + - WEBSOCKET + - HTTP + description: Represents a protocol type. + Tags: + type: object + description: Represents a collection of tags associated with the resource. + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And1600' + Api: + type: object + required: + - RouteSelectionExpression + - Name + - ProtocolType + properties: + ApiEndpoint: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: apiEndpoint + description: 'The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.' + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it. + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API ID. + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: A CORS configuration. Supported only for HTTP APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the API was created. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + ImportInfo: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: importInfo + description: The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + ProtocolType: + allOf: + - $ref: '#/components/schemas/ProtocolType' + - xml: + name: protocolType + description: The API protocol. + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: A collection of tags associated with the API. + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + Warnings: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: warnings + description: The warning messages reported when failonwarnings is turned on during API import. + description: Represents an API. + SelectionKey: + type: string + description: 'After evaluating a selection expression, the result is compared against one or more selection keys to find a matching key. See Selection Expressions for a list of expressions and each expression''s associated selection key type.' + ApiMapping: + type: object + required: + - Stage + - ApiId + properties: + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API identifier. + ApiMappingId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiMappingId + description: The API mapping identifier. + ApiMappingKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: apiMappingKey + description: The API mapping key. + Stage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stage + description: The API stage. + description: Represents an API mapping. + AuthorizationScopes: + type: array + description: 'A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.' + items: + $ref: '#/components/schemas/StringWithLengthBetween1And64' + AuthorizationType: + type: string + enum: + - NONE + - AWS_IAM + - CUSTOM + - JWT + description: 'The authorization type. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer. For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + IntegerWithLengthBetween0And3600: + type: integer + description: 'An integer with a value between [0-3600].' + minimum: 0 + maximum: 3600 + AuthorizerType: + type: string + enum: + - REQUEST + - JWT + description: The authorizer type. Specify REQUEST for a Lambda function using incoming request parameters. Specify JWT to use JSON Web Tokens (supported only for HTTP APIs). + IdentitySourceList: + type: array + description: 'The identity source for which authorization is requested. For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header, a Name query string parameter are defined as identity sources, this value is $method.request.header.Auth, $method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.' + items: + $ref: '#/components/schemas/__string' + JWTConfiguration: + type: object + properties: + Audience: + allOf: + - $ref: '#/components/schemas/__listOf__string' + - xml: + name: audience + description: 'A list of the intended recipients of the JWT. A valid JWT must provide an aud that matches at least one entry in this list. See RFC 7519. Supported only for HTTP APIs.' + Issuer: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: issuer + description: |- + The base domain of the identity provider that issues JSON Web Tokens. For example, an Amazon Cognito user pool has the following format: https://cognito-idp.The identity source for which authorization is requested.
For a REQUEST authorizer, this is optional. The value is a set of one or more mapping expressions of the specified request parameters. The identity source can be headers, query string parameters, stage variables, and context parameters. For example, if an Auth header and a Name query string parameter are defined as identity sources, this value is route.request.header.Auth, route.request.querystring.Name for WebSocket APIs. For HTTP APIs, use selection expressions prefixed with $, for example, $request.header.Auth, $request.querystring.Name. These parameters are used to perform runtime validation for Lambda-based authorizers by verifying all of the identity-related request parameters are present in the request, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function. Otherwise, it returns a 401 Unauthorized response without calling the Lambda function. For HTTP APIs, identity sources are also used as the cache key when caching is enabled. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.
For JWT, a single entry that specifies where to extract the JSON Web Token (JWT) from inbound requests. Currently only header-based and query parameter-based selections are supported, for example $request.header.Authorization.
' + IdentityValidationExpression: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: identityValidationExpression + description: The validation expression does not apply to the REQUEST authorizer. + JwtConfiguration: + allOf: + - $ref: '#/components/schemas/JWTConfiguration' + - xml: + name: jwtConfiguration + description: Represents the configuration of a JWT authorizer. Required for the JWT authorizer type. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the authorizer. + description: Represents an authorizer. + ConnectionType: + type: string + enum: + - INTERNET + - VPC_LINK + description: Represents a connection type. + ContentHandlingStrategy: + type: string + enum: + - CONVERT_TO_BINARY + - CONVERT_TO_TEXT + description: Specifies how to handle response payload content type conversions. Supported only for WebSocket APIs. + CreateApiMappingRequest: + type: object + required: + - Stage + - ApiId + title: CreateApiMappingRequest + properties: + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API identifier. + ApiMappingKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: apiMappingKey + description: The API mapping key. + Stage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stage + description: The API stage. + description: Creates a new ApiMapping resource to represent an API mapping. + CreateApiRequest: + type: object + required: + - ProtocolType + - Name + title: CreateApiRequest + properties: + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: 'A CORS configuration. Supported only for HTTP APIs. See Configuring CORS for more information.' + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'This property is part of quick create. It specifies the credentials required for the integration, if any. For a Lambda integration, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null. Currently, this property is not used for HTTP integrations. Supported only for HTTP APIs.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + ProtocolType: + allOf: + - $ref: '#/components/schemas/ProtocolType' + - xml: + name: protocolType + description: The API protocol. + RouteKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeKey + description: 'This property is part of quick create. If you don''t specify a routeKey, a default route of $default is created. The $default route acts as a catch-all for any request made to your API, for a particular stage. The $default route key can''t be modified. You can add routes after creating the API, and you can update the route keys of additional routes. Supported only for HTTP APIs.' + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags. Each tag element is associated with a given resource. + Target: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: target + description: 'This property is part of quick create. Quick create produces an API with an integration, a default catch-all route, and a default stage which is configured to automatically deploy changes. For HTTP integrations, specify a fully qualified URL. For Lambda integrations, specify a function ARN. The type of the integration will be HTTP_PROXY or AWS_PROXY, respectively. Supported only for HTTP APIs.' + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + description: Creates a new Api resource to represent an API. + CreateAuthorizerRequest: + type: object + required: + - AuthorizerType + - IdentitySource + - Name + title: CreateAuthorizerRequest + properties: + AuthorizerCredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: authorizerCredentialsArn + description: 'Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, don''t specify this parameter. Supported only for REQUEST authorizers.' + AuthorizerPayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: authorizerPayloadFormatVersion + description: 'Specifies the format of the payload sent to an HTTP API Lambda authorizer. Required for HTTP API Lambda authorizers. Supported values are 1.0 and 2.0. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.' + AuthorizerResultTtlInSeconds: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween0And3600' + - xml: + name: authorizerResultTtlInSeconds + description: 'The time to live (TTL) for cached authorizer results, in seconds. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway caches authorizer responses. The maximum value is 3600, or 1 hour. Supported only for HTTP API Lambda authorizers.' + AuthorizerType: + allOf: + - $ref: '#/components/schemas/AuthorizerType' + - xml: + name: authorizerType + description: The authorizer type. Specify REQUEST for a Lambda function using incoming request parameters. Specify JWT to use JSON Web Tokens (supported only for HTTP APIs). + AuthorizerUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: authorizerUri + description: |- + The authorizer's Uniform Resource Identifier (URI). For REQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:The identity source for which authorization is requested.
For a REQUEST authorizer, this is optional. The value is a set of one or more mapping expressions of the specified request parameters. The identity source can be headers, query string parameters, stage variables, and context parameters. For example, if an Auth header and a Name query string parameter are defined as identity sources, this value is route.request.header.Auth, route.request.querystring.Name for WebSocket APIs. For HTTP APIs, use selection expressions prefixed with $, for example, $request.header.Auth, $request.querystring.Name. These parameters are used to perform runtime validation for Lambda-based authorizers by verifying all of the identity-related request parameters are present in the request, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function. Otherwise, it returns a 401 Unauthorized response without calling the Lambda function. For HTTP APIs, identity sources are also used as the cache key when caching is enabled. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.
For JWT, a single entry that specifies where to extract the JSON Web Token (JWT) from inbound requests. Currently only header-based and query parameter-based selections are supported, for example $request.header.Authorization.
' + IdentityValidationExpression: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: identityValidationExpression + description: This parameter is not used. + JwtConfiguration: + allOf: + - $ref: '#/components/schemas/JWTConfiguration' + - xml: + name: jwtConfiguration + description: Represents the configuration of a JWT authorizer. Required for the JWT authorizer type. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the authorizer. + description: Creates a new Authorizer resource to represent an authorizer. + CreateDeploymentRequest: + type: object + title: CreateDeploymentRequest + properties: + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description for the deployment resource. + StageName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stageName + description: The name of the Stage resource for the Deployment resource to create. + description: Creates a new Deployment resource to represent a deployment. + DeploymentStatus: + type: string + enum: + - PENDING + - FAILED + - DEPLOYED + description: Represents a deployment status. + DomainNameConfigurations: + type: array + description: The domain name configurations. + items: + $ref: '#/components/schemas/DomainNameConfiguration' + MutualTlsAuthenticationInput: + type: object + properties: + TruststoreUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: truststoreUri + description: 'An Amazon S3 URL that specifies the truststore for mutual TLS authentication, for example, s3://Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the integration. + IntegrationMethod: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: integrationMethod + description: Specifies the integration's HTTP method type. + IntegrationSubtype: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: integrationSubtype + description: 'Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke. To learn more, see Integration subtype reference.' + IntegrationType: + allOf: + - $ref: '#/components/schemas/IntegrationType' + - xml: + name: integrationType + description: 'The integration type of an integration. One of the following:
AWS: for integrating the route or method request with an AWS service action, including the Lambda function-invoking action. With the Lambda function-invoking action, this is referred to as the Lambda custom integration. With any other AWS service action, this is known as AWS integration. Supported only for WebSocket APIs.
AWS_PROXY: for integrating the route or method request with a Lambda function or other AWS service action. This integration is also referred to as a Lambda proxy integration.
HTTP: for integrating the route or method request with an HTTP endpoint. This integration is also referred to as the HTTP custom integration. Supported only for WebSocket APIs.
HTTP_PROXY: for integrating the route or method request with an HTTP endpoint, with the client request passed through as-is. This is also referred to as HTTP proxy integration. For HTTP API private integrations, use an HTTP_PROXY integration.
MOCK: for integrating the route or method request with API Gateway as a "loopback" endpoint without invoking any backend. Supported only for WebSocket APIs.
' + IntegrationUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: integrationUri + description: 'For a Lambda integration, specify the URI of a Lambda function.
For an HTTP integration, specify a fully-qualified URL.
For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service. If you specify the ARN of an AWS Cloud Map service, API Gateway uses DiscoverInstances to identify resources. You can use query parameters to target specific resources. To learn more, see DiscoverInstances. For private integrations, all resources must be owned by the same AWS account.
' + PassthroughBehavior: + allOf: + - $ref: '#/components/schemas/PassthroughBehavior' + - xml: + name: passthroughBehavior + description: 'Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
WHEN_NO_MATCH passes the request body for unmapped content types through to the integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 Unsupported Media Type response.
WHEN_NO_TEMPLATES allows pass-through when the integration has no content types mapped to templates. However, if there is at least one content type defined, unmapped content types will be rejected with the same HTTP 415 Unsupported Media Type response.
' + PayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: payloadFormatVersion + description: Specifies the format of the payload sent to an integration. Required for HTTP APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: requestParameters + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API integrations without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to the backend. The key should follow the pattern <action>:<header|querystring|path>.<location> where action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ RequestTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: requestTemplates + description: 'Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value. Supported only for WebSocket APIs.' + ResponseParameters: + allOf: + - $ref: '#/components/schemas/ResponseParameters' + - xml: + name: responseParameters + description: 'Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. Specify a key-value map from a selection key to response parameters. The selection key must be a valid HTTP status code within the range of 200-599. Response parameters are a key-value map. The key must match pattern <action>:<header>.<location> or overwrite.statuscode. The action can be append, overwrite or remove. The value can be a static value, or map to response data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expression for the integration. + TimeoutInMillis: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween50And30000' + - xml: + name: timeoutInMillis + description: 'Custom timeout between 50 and 29,000 milliseconds for WebSocket APIs and between 50 and 30,000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.' + TlsConfig: + allOf: + - $ref: '#/components/schemas/TlsConfigInput' + - xml: + name: tlsConfig + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + description: Creates a new Integration resource to represent an integration. + TlsConfig: + type: object + properties: + ServerNameToVerify: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And512' + - xml: + name: serverNameToVerify + description: 'If you specify a server name, API Gateway uses it to verify the hostname on the integration''s certificate. The server name is also included in the TLS handshake to support Server Name Indication (SNI) or virtual hosting.' + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + CreateIntegrationResponseRequest: + type: object + required: + - IntegrationResponseKey + title: CreateIntegrationResponseRequest + properties: + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + IntegrationResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: integrationResponseKey + description: The integration response key. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: responseParameters + description: 'A key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.{name}, where {name} is a valid and unique header name. The mapped non-static value must match the pattern of integration.response.header.{name} or integration.response.body.{JSON-expression}, where {name} is a valid and unique response header name and {JSON-expression} is a valid JSON expression without the $ prefix.' + ResponseTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: responseTemplates + description: 'The collection of response templates for the integration response as a string-to-string map of key-value pairs. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expression for the integration response. Supported only for WebSocket APIs. + description: Creates a new IntegrationResponse resource to represent an integration response. + StringWithLengthBetween1And256: + type: string + description: 'A string with a length between [1-256].' + CreateModelRequest: + type: object + required: + - Schema + - Name + title: CreateModelRequest + properties: + ContentType: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And256' + - xml: + name: contentType + description: 'The content-type for the model, for example, "application/json".' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the model. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the model. Must be alphanumeric. + Schema: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And32K' + - xml: + name: schema + description: 'The schema for the model. For application/json models, this should be JSON schema draft 4 model.' + description: Creates a new Model. + RouteModels: + type: object + description: The route models. + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween1And128' + RouteParameters: + type: object + description: The route parameters. + additionalProperties: + $ref: '#/components/schemas/ParameterConstraints' + CreateRouteRequest: + type: object + required: + - RouteKey + title: CreateRouteRequest + properties: + ApiKeyRequired: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiKeyRequired + description: Specifies whether an API key is required for the route. Supported only for WebSocket APIs. + AuthorizationScopes: + allOf: + - $ref: '#/components/schemas/AuthorizationScopes' + - xml: + name: authorizationScopes + description: The authorization scopes supported by this route. + AuthorizationType: + allOf: + - $ref: '#/components/schemas/AuthorizationType' + - xml: + name: authorizationType + description: 'The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer. + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: The model selection expression for the route. Supported only for WebSocket APIs. + OperationName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: operationName + description: The operation name for the route. + RequestModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: requestModels + description: The request models for the route. Supported only for WebSocket APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: requestParameters + description: The request parameters for the route. Supported only for WebSocket APIs. + RouteKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeKey + description: The route key for the route. + RouteResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeResponseSelectionExpression + description: The route response selection expression for the route. Supported only for WebSocket APIs. + Target: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: target + description: The target for the route. + description: Creates a new Route resource to represent a route. + CreateRouteResponseRequest: + type: object + required: + - RouteResponseKey + title: CreateRouteResponseRequest + properties: + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: The model selection expression for the route response. Supported only for WebSocket APIs. + ResponseModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: responseModels + description: The response models for the route response. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: responseParameters + description: The route response parameters. + RouteResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeResponseKey + description: The route response key. + description: Creates a new RouteResponse resource to represent a route response. + RouteSettingsMap: + type: object + description: The route settings map. + additionalProperties: + $ref: '#/components/schemas/RouteSettings' + StageVariablesMap: + type: object + description: The stage variable map. + additionalProperties: + $ref: '#/components/schemas/StringWithLengthBetween0And2048' + CreateStageRequest: + type: object + required: + - StageName + title: CreateStageRequest + properties: + AccessLogSettings: + allOf: + - $ref: '#/components/schemas/AccessLogSettings' + - xml: + name: accessLogSettings + description: Settings for logging access in this stage. + AutoDeploy: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeploy + description: Specifies whether updates to an API automatically trigger a new deployment. The default value is false. + ClientCertificateId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: clientCertificateId + description: The identifier of a client certificate for a Stage. Supported only for WebSocket APIs. + DefaultRouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettings' + - xml: + name: defaultRouteSettings + description: The default route settings for the stage. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The deployment identifier of the API stage. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description for the API stage. + RouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettingsMap' + - xml: + name: routeSettings + description: 'Route settings for the stage, by routeKey.' + StageName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stageName + description: The name of the stage. + StageVariables: + allOf: + - $ref: '#/components/schemas/StageVariablesMap' + - xml: + name: stageVariables + description: 'A map that defines the stage variables for a Stage. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags. Each tag element is associated with a given resource. + description: Creates a new Stage resource to represent a stage. + SecurityGroupIdList: + type: array + description: A list of security group IDs for the VPC link. + items: + $ref: '#/components/schemas/__string' + SubnetIdList: + type: array + description: A list of subnet IDs to include in the VPC link. + items: + $ref: '#/components/schemas/__string' + CreateVpcLinkRequest: + type: object + required: + - SubnetIds + - Name + title: CreateVpcLinkRequest + properties: + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the VPC link. + SecurityGroupIds: + allOf: + - $ref: '#/components/schemas/SecurityGroupIdList' + - xml: + name: securityGroupIds + description: A list of security group IDs for the VPC link. + SubnetIds: + allOf: + - $ref: '#/components/schemas/SubnetIdList' + - xml: + name: subnetIds + description: A list of subnet IDs to include in the VPC link. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: A list of tags. + description: Creates a VPC link + VpcLinkStatus: + type: string + enum: + - PENDING + - AVAILABLE + - DELETING + - FAILED + - INACTIVE + description: The status of the VPC link. + VpcLinkVersion: + type: string + enum: + - V2 + description: The version of the VPC link. + DeleteAccessLogSettingsRequest: + type: object + title: DeleteAccessLogSettingsRequest + properties: {} + DeleteApiMappingRequest: + type: object + title: DeleteApiMappingRequest + properties: {} + DeleteApiRequest: + type: object + title: DeleteApiRequest + properties: {} + DeleteAuthorizerRequest: + type: object + title: DeleteAuthorizerRequest + properties: {} + DeleteCorsConfigurationRequest: + type: object + title: DeleteCorsConfigurationRequest + properties: {} + DeleteDeploymentRequest: + type: object + title: DeleteDeploymentRequest + properties: {} + DeleteDomainNameRequest: + type: object + title: DeleteDomainNameRequest + properties: {} + DeleteIntegrationRequest: + type: object + title: DeleteIntegrationRequest + properties: {} + DeleteIntegrationResponseRequest: + type: object + title: DeleteIntegrationResponseRequest + properties: {} + DeleteModelRequest: + type: object + title: DeleteModelRequest + properties: {} + DeleteRouteRequest: + type: object + title: DeleteRouteRequest + properties: {} + DeleteRouteRequestParameterRequest: + type: object + title: DeleteRouteRequestParameterRequest + properties: {} + DeleteRouteResponseRequest: + type: object + title: DeleteRouteResponseRequest + properties: {} + DeleteRouteSettingsRequest: + type: object + title: DeleteRouteSettingsRequest + properties: {} + DeleteStageRequest: + type: object + title: DeleteStageRequest + properties: {} + DeleteVpcLinkRequest: + type: object + title: DeleteVpcLinkRequest + properties: {} + Deployment: + type: object + properties: + AutoDeployed: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeployed + description: Specifies whether a deployment was automatically released. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The date and time when the Deployment resource was created. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier for the deployment. + DeploymentStatus: + allOf: + - $ref: '#/components/schemas/DeploymentStatus' + - xml: + name: deploymentStatus + description: 'The status of the deployment: PENDING, FAILED, or SUCCEEDED.' + DeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: deploymentStatusMessage + description: May contain additional feedback on the status of an API deployment. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description for the deployment. + description: An immutable representation of an API that can be called by users. A Deployment must be associated with a Stage for it to be callable over the internet. + DomainName: + type: object + required: + - DomainName + properties: + ApiMappingSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiMappingSelectionExpression + description: The API mapping selection expression. + DomainName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And512' + - xml: + name: domainName + description: The name of the DomainName resource. + DomainNameConfigurations: + allOf: + - $ref: '#/components/schemas/DomainNameConfigurations' + - xml: + name: domainNameConfigurations + description: The domain name configurations. + MutualTlsAuthentication: + allOf: + - $ref: '#/components/schemas/MutualTlsAuthentication' + - xml: + name: mutualTlsAuthentication + description: The mutual TLS authentication configuration for a custom domain name. + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags associated with a domain name. + description: Represents a domain name. + DomainNameStatus: + type: string + enum: + - AVAILABLE + - UPDATING + description: 'The status of the domain name migration. The valid values are AVAILABLE and UPDATING. If the status is UPDATING, the domain cannot be modified further until the existing operation is complete. If it is AVAILABLE, the domain can be updated.' + EndpointType: + type: string + enum: + - REGIONAL + - EDGE + description: Represents an endpoint type. + SecurityPolicy: + type: string + enum: + - TLS_1_0 + - TLS_1_2 + description: The Transport Layer Security (TLS) version of the security policy for this domain name. The valid values are TLS_1_0 and TLS_1_2. + ExportApiRequest: + type: object + title: ExportApiRequest + properties: {} + ExportedApi: + type: string + description: 'Represents an exported definition of an API in a particular output format, for example, YAML. The API is serialized to the requested specification, for example, OpenAPI 3.0.' + ResetAuthorizersCacheRequest: + type: object + title: ResetAuthorizersCacheRequest + properties: {} + GetApiMappingRequest: + type: object + title: GetApiMappingRequest + properties: {} + GetApiMappingsRequest: + type: object + title: GetApiMappingsRequest + properties: {} + __listOfApiMapping: + type: array + items: + $ref: '#/components/schemas/ApiMapping' + NextToken: + type: string + description: The next page of elements from this collection. Not valid for the last element of the collection. + GetApiRequest: + type: object + title: GetApiRequest + properties: {} + GetApisRequest: + type: object + title: GetApisRequest + properties: {} + __listOfApi: + type: array + items: + $ref: '#/components/schemas/Api' + GetAuthorizerRequest: + type: object + title: GetAuthorizerRequest + properties: {} + GetAuthorizersRequest: + type: object + title: GetAuthorizersRequest + properties: {} + __listOfAuthorizer: + type: array + items: + $ref: '#/components/schemas/Authorizer' + GetDeploymentRequest: + type: object + title: GetDeploymentRequest + properties: {} + GetDeploymentsRequest: + type: object + title: GetDeploymentsRequest + properties: {} + __listOfDeployment: + type: array + items: + $ref: '#/components/schemas/Deployment' + GetDomainNameRequest: + type: object + title: GetDomainNameRequest + properties: {} + GetDomainNamesRequest: + type: object + title: GetDomainNamesRequest + properties: {} + __listOfDomainName: + type: array + items: + $ref: '#/components/schemas/DomainName' + GetIntegrationRequest: + type: object + title: GetIntegrationRequest + properties: {} + GetIntegrationResponseRequest: + type: object + title: GetIntegrationResponseRequest + properties: {} + GetIntegrationResponsesRequest: + type: object + title: GetIntegrationResponsesRequest + properties: {} + __listOfIntegrationResponse: + type: array + items: + $ref: '#/components/schemas/IntegrationResponse' + GetIntegrationsRequest: + type: object + title: GetIntegrationsRequest + properties: {} + __listOfIntegration: + type: array + items: + $ref: '#/components/schemas/Integration' + GetModelRequest: + type: object + title: GetModelRequest + properties: {} + GetModelTemplateRequest: + type: object + title: GetModelTemplateRequest + properties: {} + GetModelsRequest: + type: object + title: GetModelsRequest + properties: {} + __listOfModel: + type: array + items: + $ref: '#/components/schemas/Model' + GetRouteRequest: + type: object + title: GetRouteRequest + properties: {} + GetRouteResponseRequest: + type: object + title: GetRouteResponseRequest + properties: {} + GetRouteResponsesRequest: + type: object + title: GetRouteResponsesRequest + properties: {} + __listOfRouteResponse: + type: array + items: + $ref: '#/components/schemas/RouteResponse' + GetRoutesRequest: + type: object + title: GetRoutesRequest + properties: {} + __listOfRoute: + type: array + items: + $ref: '#/components/schemas/Route' + GetStageRequest: + type: object + title: GetStageRequest + properties: {} + GetStagesRequest: + type: object + title: GetStagesRequest + properties: {} + __listOfStage: + type: array + items: + $ref: '#/components/schemas/Stage' + GetTagsRequest: + type: object + title: GetTagsRequest + properties: {} + GetVpcLinkRequest: + type: object + title: GetVpcLinkRequest + properties: {} + GetVpcLinksRequest: + type: object + title: GetVpcLinksRequest + properties: {} + __listOfVpcLink: + type: array + items: + $ref: '#/components/schemas/VpcLink' + ImportApiRequest: + type: object + required: + - Body + title: ImportApiRequest + properties: + Body: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: body + description: The OpenAPI definition. Supported only for HTTP APIs. + description: '' + Integration: + type: object + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether an integration is managed by API Gateway. If you created an API using using quick create, the resulting integration is managed by API Gateway. You can update a managed integration, but you can''t delete it.' + ConnectionId: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: connectionId + description: The ID of the VPC link for a private integration. Supported only for HTTP APIs. + ConnectionType: + allOf: + - $ref: '#/components/schemas/ConnectionType' + - xml: + name: connectionType + description: The type of the network connection to the integration endpoint. Specify INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and resources in a VPC. The default value is INTERNET. + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: Represents the description of an integration. + IntegrationId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationId + description: Represents the identifier of an integration. + IntegrationMethod: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: integrationMethod + description: Specifies the integration's HTTP method type. + IntegrationResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: integrationResponseSelectionExpression + description: 'The integration response selection expression for the integration. Supported only for WebSocket APIs. See Integration Response Selection Expressions.' + IntegrationSubtype: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: integrationSubtype + description: 'Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke. To learn more, see Integration subtype reference.' + IntegrationType: + allOf: + - $ref: '#/components/schemas/IntegrationType' + - xml: + name: integrationType + description: 'The integration type of an integration. One of the following:
AWS: for integrating the route or method request with an AWS service action, including the Lambda function-invoking action. With the Lambda function-invoking action, this is referred to as the Lambda custom integration. With any other AWS service action, this is known as AWS integration. Supported only for WebSocket APIs.
AWS_PROXY: for integrating the route or method request with a Lambda function or other AWS service action. This integration is also referred to as a Lambda proxy integration.
HTTP: for integrating the route or method request with an HTTP endpoint. This integration is also referred to as the HTTP custom integration. Supported only for WebSocket APIs.
HTTP_PROXY: for integrating the route or method request with an HTTP endpoint, with the client request passed through as-is. This is also referred to as HTTP proxy integration.
MOCK: for integrating the route or method request with API Gateway as a "loopback" endpoint without invoking any backend. Supported only for WebSocket APIs.
' + IntegrationUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: integrationUri + description: 'For a Lambda integration, specify the URI of a Lambda function.
For an HTTP integration, specify a fully-qualified URL.
For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service. If you specify the ARN of an AWS Cloud Map service, API Gateway uses DiscoverInstances to identify resources. You can use query parameters to target specific resources. To learn more, see DiscoverInstances. For private integrations, all resources must be owned by the same AWS account.
' + PassthroughBehavior: + allOf: + - $ref: '#/components/schemas/PassthroughBehavior' + - xml: + name: passthroughBehavior + description: 'Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
WHEN_NO_MATCH passes the request body for unmapped content types through to the integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 Unsupported Media Type response.
WHEN_NO_TEMPLATES allows pass-through when the integration has no content types mapped to templates. However, if there is at least one content type defined, unmapped content types will be rejected with the same HTTP 415 Unsupported Media Type response.
' + PayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: payloadFormatVersion + description: Specifies the format of the payload sent to an integration. Required for HTTP APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: requestParameters + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API itegrations, without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to backend integrations. The key should follow the pattern <action>:<header|querystring|path>.<location>. The action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ RequestTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: requestTemplates + description: 'Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value. Supported only for WebSocket APIs.' + ResponseParameters: + allOf: + - $ref: '#/components/schemas/ResponseParameters' + - xml: + name: responseParameters + description: 'Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. Specify a key-value map from a selection key to response parameters. The selection key must be a valid HTTP status code within the range of 200-599. Response parameters are a key-value map. The key must match pattern <action>:<header>.<location> or overwrite.statuscode. The action can be append, overwrite or remove. The value can be a static value, or map to response data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expression for the integration. Supported only for WebSocket APIs. + TimeoutInMillis: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween50And30000' + - xml: + name: timeoutInMillis + description: 'Custom timeout between 50 and 29,000 milliseconds for WebSocket APIs and between 50 and 30,000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.' + TlsConfig: + allOf: + - $ref: '#/components/schemas/TlsConfig' + - xml: + name: tlsConfig + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + description: Represents an integration. + IntegrationResponse: + type: object + required: + - IntegrationResponseKey + properties: + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + IntegrationResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: integrationResponseId + description: The integration response ID. + IntegrationResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: integrationResponseKey + description: The integration response key. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: responseParameters + description: 'A key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.{name}, where name is a valid and unique header name. The mapped non-static value must match the pattern of integration.response.header.{name} or integration.response.body.{JSON-expression}, where name is a valid and unique response header name and JSON-expression is a valid JSON expression without the $ prefix.' + ResponseTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: responseTemplates + description: 'The collection of response templates for the integration response as a string-to-string map of key-value pairs. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expressions for the integration response. + description: Represents an integration response. + Model: + type: object + required: + - Name + properties: + ContentType: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And256' + - xml: + name: contentType + description: 'The content-type for the model, for example, "application/json".' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the model. + ModelId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: modelId + description: The model identifier. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the model. Must be alphanumeric. + Schema: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And32K' + - xml: + name: schema + description: 'The schema for the model. For application/json models, this should be JSON schema draft 4 model.' + description: 'Represents a data model for an API. Supported only for WebSocket APIs. See Create Models and Mapping Templates for Request and Response Mappings.' + ReimportApiRequest: + type: object + required: + - Body + title: ReimportApiRequest + properties: + Body: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: body + description: The OpenAPI definition. Supported only for HTTP APIs. + description: '' + Route: + type: object + required: + - RouteKey + properties: + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a route is managed by API Gateway. If you created an API using quick create, the $default route is managed by API Gateway. You can''t modify the $default route key.' + ApiKeyRequired: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiKeyRequired + description: Specifies whether an API key is required for this route. Supported only for WebSocket APIs. + AuthorizationScopes: + allOf: + - $ref: '#/components/schemas/AuthorizationScopes' + - xml: + name: authorizationScopes + description: 'A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.' + AuthorizationType: + allOf: + - $ref: '#/components/schemas/AuthorizationType' + - xml: + name: authorizationType + description: 'The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.' + AuthorizerId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: authorizerId + description: The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer. + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: The model selection expression for the route. Supported only for WebSocket APIs. + OperationName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: operationName + description: The operation name for the route. + RequestModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: requestModels + description: The request models for the route. Supported only for WebSocket APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: requestParameters + description: The request parameters for the route. Supported only for WebSocket APIs. + RouteId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeId + description: The route ID. + RouteKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeKey + description: The route key for the route. + RouteResponseSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeResponseSelectionExpression + description: The route response selection expression for the route. Supported only for WebSocket APIs. + Target: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: target + description: The target for the route. + description: Represents a route. + RouteResponse: + type: object + required: + - RouteResponseKey + properties: + ModelSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: modelSelectionExpression + description: Represents the model selection expression of a route response. Supported only for WebSocket APIs. + ResponseModels: + allOf: + - $ref: '#/components/schemas/RouteModels' + - xml: + name: responseModels + description: Represents the response models of a route response. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/RouteParameters' + - xml: + name: responseParameters + description: Represents the response parameters of a route response. + RouteResponseId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: routeResponseId + description: Represents the identifier of a route response. + RouteResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeResponseKey + description: Represents the route response key of a route response. + description: Represents a route response. + Stage: + type: object + required: + - StageName + properties: + AccessLogSettings: + allOf: + - $ref: '#/components/schemas/AccessLogSettings' + - xml: + name: accessLogSettings + description: Settings for logging access in this stage. + ApiGatewayManaged: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: apiGatewayManaged + description: 'Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can''t modify the $default stage.' + AutoDeploy: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: autoDeploy + description: Specifies whether updates to an API automatically trigger a new deployment. The default value is false. + ClientCertificateId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: clientCertificateId + description: The identifier of a client certificate for a Stage. Supported only for WebSocket APIs. + CreatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: createdDate + description: The timestamp when the stage was created. + DefaultRouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettings' + - xml: + name: defaultRouteSettings + description: Default route settings for the stage. + DeploymentId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: deploymentId + description: The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled. + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the stage. + LastDeploymentStatusMessage: + allOf: + - $ref: '#/components/schemas/__string' + - xml: + name: lastDeploymentStatusMessage + description: Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled. + LastUpdatedDate: + allOf: + - $ref: '#/components/schemas/__timestampIso8601' + - xml: + name: lastUpdatedDate + description: The timestamp when the stage was last updated. + RouteSettings: + allOf: + - $ref: '#/components/schemas/RouteSettingsMap' + - xml: + name: routeSettings + description: 'Route settings for the stage, by routeKey.' + StageName: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stageName + description: The name of the stage. + StageVariables: + allOf: + - $ref: '#/components/schemas/StageVariablesMap' + - xml: + name: stageVariables + description: 'A map that defines the stage variables for a stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.' + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags. Each tag element is associated with a given resource. + description: Represents an API stage. + TagResourceRequest: + type: object + title: TagResourceRequest + properties: + Tags: + allOf: + - $ref: '#/components/schemas/Tags' + - xml: + name: tags + description: The collection of tags. Each tag element is associated with a given resource. + description: Creates a new Tag resource to represent a tag. + UntagResourceRequest: + type: object + title: UntagResourceRequest + properties: {} + UpdateApiMappingRequest: + type: object + required: + - ApiId + title: UpdateApiMappingRequest + properties: + ApiId: + allOf: + - $ref: '#/components/schemas/Id' + - xml: + name: apiId + description: The API identifier. + ApiMappingKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: apiMappingKey + description: The API mapping key. + Stage: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: stage + description: The API stage. + description: Updates an ApiMapping. + UpdateApiRequest: + type: object + title: UpdateApiRequest + properties: + ApiKeySelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: apiKeySelectionExpression + description: 'An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.' + CorsConfiguration: + allOf: + - $ref: '#/components/schemas/Cors' + - xml: + name: corsConfiguration + description: A CORS configuration. Supported only for HTTP APIs. + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'This property is part of quick create. It specifies the credentials required for the integration, if any. For a Lambda integration, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, don''t specify this parameter. Currently, this property is not used for HTTP integrations. If provided, this value replaces the credentials associated with the quick create integration. Supported only for HTTP APIs.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the API. + DisableSchemaValidation: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableSchemaValidation + description: Avoid validating models when creating a deployment. Supported only for WebSocket APIs. + DisableExecuteApiEndpoint: + allOf: + - $ref: '#/components/schemas/__boolean' + - xml: + name: disableExecuteApiEndpoint + description: 'Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.' + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the API. + RouteKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: routeKey + description: 'This property is part of quick create. If not specified, the route created using quick create is kept. Otherwise, this value replaces the route key of the quick create route. Additional routes may still be added after the API is updated. Supported only for HTTP APIs.' + RouteSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: routeSelectionExpression + description: 'The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.' + Target: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: target + description: 'This property is part of quick create. For HTTP integrations, specify a fully qualified URL. For Lambda integrations, specify a function ARN. The type of the integration will be HTTP_PROXY or AWS_PROXY, respectively. The value provided updates the integration URI and integration type. You can update a quick-created target, but you can''t remove it from an API. Supported only for HTTP APIs.' + Version: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: version + description: A version identifier for the API. + description: Updates an Api. + UpdateAuthorizerRequest: + type: object + title: UpdateAuthorizerRequest + properties: + AuthorizerCredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: authorizerCredentialsArn + description: 'Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, don''t specify this parameter.' + AuthorizerPayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: authorizerPayloadFormatVersion + description: 'Specifies the format of the payload sent to an HTTP API Lambda authorizer. Required for HTTP API Lambda authorizers. Supported values are 1.0 and 2.0. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.' + AuthorizerResultTtlInSeconds: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween0And3600' + - xml: + name: authorizerResultTtlInSeconds + description: 'The time to live (TTL) for cached authorizer results, in seconds. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway caches authorizer responses. The maximum value is 3600, or 1 hour. Supported only for HTTP API Lambda authorizers.' + AuthorizerType: + allOf: + - $ref: '#/components/schemas/AuthorizerType' + - xml: + name: authorizerType + description: The authorizer type. Specify REQUEST for a Lambda function using incoming request parameters. Specify JWT to use JSON Web Tokens (supported only for HTTP APIs). + AuthorizerUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: authorizerUri + description: |- + The authorizer's Uniform Resource Identifier (URI). For REQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:The identity source for which authorization is requested.
For a REQUEST authorizer, this is optional. The value is a set of one or more mapping expressions of the specified request parameters. The identity source can be headers, query string parameters, stage variables, and context parameters. For example, if an Auth header and a Name query string parameter are defined as identity sources, this value is route.request.header.Auth, route.request.querystring.Name for WebSocket APIs. For HTTP APIs, use selection expressions prefixed with $, for example, $request.header.Auth, $request.querystring.Name. These parameters are used to perform runtime validation for Lambda-based authorizers by verifying all of the identity-related request parameters are present in the request, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function. Otherwise, it returns a 401 Unauthorized response without calling the Lambda function. For HTTP APIs, identity sources are also used as the cache key when caching is enabled. To learn more, see Working with AWS Lambda authorizers for HTTP APIs.
For JWT, a single entry that specifies where to extract the JSON Web Token (JWT) from inbound requests. Currently only header-based and query parameter-based selections are supported, for example $request.header.Authorization.
' + IdentityValidationExpression: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: identityValidationExpression + description: This parameter is not used. + JwtConfiguration: + allOf: + - $ref: '#/components/schemas/JWTConfiguration' + - xml: + name: jwtConfiguration + description: Represents the configuration of a JWT authorizer. Required for the JWT authorizer type. Supported only for HTTP APIs. + Name: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: name + description: The name of the authorizer. + description: Updates an Authorizer. + UpdateDeploymentRequest: + type: object + title: UpdateDeploymentRequest + properties: + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description for the deployment resource. + description: Updates a Deployment. + UpdateDomainNameRequest: + type: object + title: UpdateDomainNameRequest + properties: + DomainNameConfigurations: + allOf: + - $ref: '#/components/schemas/DomainNameConfigurations' + - xml: + name: domainNameConfigurations + description: The domain name configurations. + MutualTlsAuthentication: + allOf: + - $ref: '#/components/schemas/MutualTlsAuthenticationInput' + - xml: + name: mutualTlsAuthentication + description: The mutual TLS authentication configuration for a custom domain name. + description: Updates a DomainName. + UpdateIntegrationRequest: + type: object + title: UpdateIntegrationRequest + properties: + ConnectionId: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And1024' + - xml: + name: connectionId + description: The ID of the VPC link for a private integration. Supported only for HTTP APIs. + ConnectionType: + allOf: + - $ref: '#/components/schemas/ConnectionType' + - xml: + name: connectionType + description: The type of the network connection to the integration endpoint. Specify INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and resources in a VPC. The default value is INTERNET. + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + CredentialsArn: + allOf: + - $ref: '#/components/schemas/Arn' + - xml: + name: credentialsArn + description: 'Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role''s Amazon Resource Name (ARN). To require that the caller''s identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null.' + Description: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween0And1024' + - xml: + name: description + description: The description of the integration + IntegrationMethod: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: integrationMethod + description: Specifies the integration's HTTP method type. + IntegrationSubtype: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And128' + - xml: + name: integrationSubtype + description: 'Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke. To learn more, see Integration subtype reference.' + IntegrationType: + allOf: + - $ref: '#/components/schemas/IntegrationType' + - xml: + name: integrationType + description: 'The integration type of an integration. One of the following:
AWS: for integrating the route or method request with an AWS service action, including the Lambda function-invoking action. With the Lambda function-invoking action, this is referred to as the Lambda custom integration. With any other AWS service action, this is known as AWS integration. Supported only for WebSocket APIs.
AWS_PROXY: for integrating the route or method request with a Lambda function or other AWS service action. This integration is also referred to as a Lambda proxy integration.
HTTP: for integrating the route or method request with an HTTP endpoint. This integration is also referred to as the HTTP custom integration. Supported only for WebSocket APIs.
HTTP_PROXY: for integrating the route or method request with an HTTP endpoint, with the client request passed through as-is. This is also referred to as HTTP proxy integration. For HTTP API private integrations, use an HTTP_PROXY integration.
MOCK: for integrating the route or method request with API Gateway as a "loopback" endpoint without invoking any backend. Supported only for WebSocket APIs.
' + IntegrationUri: + allOf: + - $ref: '#/components/schemas/UriWithLengthBetween1And2048' + - xml: + name: integrationUri + description: 'For a Lambda integration, specify the URI of a Lambda function.
For an HTTP integration, specify a fully-qualified URL.
For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service. If you specify the ARN of an AWS Cloud Map service, API Gateway uses DiscoverInstances to identify resources. You can use query parameters to target specific resources. To learn more, see DiscoverInstances. For private integrations, all resources must be owned by the same AWS account.
' + PassthroughBehavior: + allOf: + - $ref: '#/components/schemas/PassthroughBehavior' + - xml: + name: passthroughBehavior + description: 'Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
WHEN_NO_MATCH passes the request body for unmapped content types through to the integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 Unsupported Media Type response.
WHEN_NO_TEMPLATES allows pass-through when the integration has no content types mapped to templates. However, if there is at least one content type defined, unmapped content types will be rejected with the same HTTP 415 Unsupported Media Type response.
' + PayloadFormatVersion: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And64' + - xml: + name: payloadFormatVersion + description: Specifies the format of the payload sent to an integration. Required for HTTP APIs. + RequestParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: requestParameters + description: |- +For WebSocket APIs, a key-value map specifying request parameters that are passed from the method request to the backend. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the backend. The method request parameter value must match the pattern of method.request.
For HTTP API integrations with a specified integrationSubtype, request parameters are a key-value map specifying parameters that are passed to AWS_PROXY integrations. You can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Working with AWS service integrations for HTTP APIs.
For HTTP API integrations, without a specified integrationSubtype request parameters are a key-value map specifying how to transform HTTP requests before sending them to the backend. The key should follow the pattern <action>:<header|querystring|path>.<location> where action can be append, overwrite or remove. For values, you can provide static values, or map request data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.
+ RequestTemplates: + allOf: + - $ref: '#/components/schemas/TemplateMap' + - xml: + name: requestTemplates + description: 'Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value. Supported only for WebSocket APIs.' + ResponseParameters: + allOf: + - $ref: '#/components/schemas/ResponseParameters' + - xml: + name: responseParameters + description: 'Supported only for HTTP APIs. You use response parameters to transform the HTTP response from a backend integration before returning the response to clients. Specify a key-value map from a selection key to response parameters. The selection key must be a valid HTTP status code within the range of 200-599. Response parameters are a key-value map. The key must match pattern <action>:<header>.<location> or overwrite.statuscode. The action can be append, overwrite or remove. The value can be a static value, or map to response data, stage variables, or context variables that are evaluated at runtime. To learn more, see Transforming API requests and responses.' + TemplateSelectionExpression: + allOf: + - $ref: '#/components/schemas/SelectionExpression' + - xml: + name: templateSelectionExpression + description: The template selection expression for the integration. + TimeoutInMillis: + allOf: + - $ref: '#/components/schemas/IntegerWithLengthBetween50And30000' + - xml: + name: timeoutInMillis + description: 'Custom timeout between 50 and 29,000 milliseconds for WebSocket APIs and between 50 and 30,000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.' + TlsConfig: + allOf: + - $ref: '#/components/schemas/TlsConfigInput' + - xml: + name: tlsConfig + description: 'The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.' + description: Updates an Integration. + UpdateIntegrationResponseRequest: + type: object + title: UpdateIntegrationResponseRequest + properties: + ContentHandlingStrategy: + allOf: + - $ref: '#/components/schemas/ContentHandlingStrategy' + - xml: + name: contentHandlingStrategy + description: 'Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:
CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.
CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.
If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
' + IntegrationResponseKey: + allOf: + - $ref: '#/components/schemas/SelectionKey' + - xml: + name: integrationResponseKey + description: The integration response key. + ResponseParameters: + allOf: + - $ref: '#/components/schemas/IntegrationParameters' + - xml: + name: responseParameters + description: |- + A key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.Use AWS AppConfig, a capability of AWS Systems Manager, to create, manage, and quickly deploy application configurations. AppConfig supports controlled deployments to applications of any size and includes built-in validation checks and monitoring. You can use AppConfig with applications hosted on Amazon EC2 instances, AWS Lambda, containers, mobile applications, or IoT devices.
To prevent errors when deploying application configurations, especially for production systems where a simple typo could cause an unexpected outage, AppConfig includes validators. A validator provides a syntactic or semantic check to ensure that the configuration you want to deploy works as intended. To validate your application configuration data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or update can only proceed when the configuration data is valid.
During a configuration deployment, AppConfig monitors the application to ensure that the deployment is successful. If the system encounters an error, AppConfig rolls back the change to minimize impact for your application users. You can configure a deployment strategy for each application or environment that includes deployment criteria, including velocity, bake time, and alarms to monitor. Similar to error monitoring, if a deployment triggers an alarm, AppConfig automatically rolls back to the previous version.
AppConfig supports multiple use cases. Here are some examples.
Application tuning: Use AppConfig to carefully introduce changes to your application that can only be tested with production traffic.
Feature toggle: Use AppConfig to turn on new features that require a timely deployment, such as a product launch or announcement.
Allow list: Use AppConfig to allow premium subscribers to access paid content.
Operational issues: Use AppConfig to reduce stress on your application when a dependency or other external factor impacts the system.
This reference is intended to be used with the AWS AppConfig User Guide.
' + 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: appconfig + x-aws-signingName: appconfig + x-origin: + - contentType: application/json + url: 'https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/appconfig-2019-10-09.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/appconfig/' +servers: + - url: 'http://appconfig.{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 AppConfig multi-region endpoint + - url: 'https://appconfig.{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 AppConfig multi-region endpoint + - url: 'http://appconfig.{region}.amazonaws.com.cn' + variables: + region: + description: The AWS region + enum: + - cn-north-1 + - cn-northwest-1 + default: cn-north-1 + description: The AppConfig endpoint for China (Beijing) and China (Ningxia) + - url: 'https://appconfig.{region}.amazonaws.com.cn' + variables: + region: + description: The AWS region + enum: + - cn-north-1 + - cn-northwest-1 + default: cn-north-1 + description: The AppConfig endpoint for China (Beijing) and China (Ningxia) +x-hasEquivalentPaths: true +paths: + /applications: + post: + operationId: CreateApplication + description: 'An application in AppConfig is a logical unit of code that provides capabilities for your customers. For example, an application can be a microservice that runs on Amazon EC2 instances, a mobile application installed by your users, a serverless application using Amazon API Gateway and AWS Lambda, or any system you run on behalf of others.' + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/Application' + '480': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '481': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + parameters: [] + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - Name + properties: + Name: + description: A name for the application. + type: string + minLength: 1 + maxLength: 64 + Description: + description: A description of the application. + type: string + minLength: 0 + maxLength: 1024 + Tags: + description: 'Metadata to assign to the application. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.' + type: object + minProperties: 0 + maxProperties: 50 + 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: ListApplications + description: List all applications in your AWS account. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/Applications' + '480': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + '481': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: max_results + in: query + required: false + description: The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results. + schema: + type: integer + minimum: 1 + maximum: 50 + - name: next_token + in: query + required: false + description: A token to start the list. Use this token to get the next set of results. + schema: + type: string + minLength: 1 + maxLength: 2048 + - name: MaxResults + in: query + schema: + type: string + description: Pagination limit + required: false + - name: NextToken + in: query + schema: + type: string + description: Pagination token + required: false + '/applications/{ApplicationId}/configurationprofiles': + post: + operationId: CreateConfigurationProfile + description: 'Information that enables AppConfig to access the configuration source. Valid configuration sources include Systems Manager (SSM) documents, SSM Parameter Store parameters, and Amazon S3 objects. A configuration profile includes the following information.
The Uri location of the configuration data.
The AWS Identity and Access Management (IAM) role that provides access to the configuration data.
A validator for the configuration data. Available validators include either a JSON Schema or an AWS Lambda function.
For more information, see Create a Configuration and a Configuration Profile in the AWS AppConfig User Guide.
' + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/ConfigurationProfile' + '480': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '481': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '482': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + parameters: + - name: ApplicationId + in: path + required: true + description: The application ID. + schema: + type: string + pattern: '[a-z0-9]{4,7}' + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - Name + - LocationUri + properties: + Name: + description: A name for the configuration profile. + type: string + minLength: 1 + maxLength: 64 + Description: + description: A description of the configuration profile. + type: string + minLength: 0 + maxLength: 1024 + LocationUri: + description: 'A URI to locate the configuration. You can specify a Systems Manager (SSM) document, an SSM Parameter Store parameter, or an Amazon S3 object. For an SSM document, specify either the document name in the formatssm-document://<Document_name> or the Amazon Resource Name (ARN). For a parameter, specify either the parameter name in the format ssm-parameter://<Parameter_name> or the ARN. For an Amazon S3 object, specify the URI in the following format: s3://<bucket>/<objectKey> . Here is an example: s3://my-bucket/my-app/us-east-1/my-config.json'
+ type: string
+ minLength: 1
+ maxLength: 2048
+ RetrievalRoleArn:
+ description: The ARN of an IAM role with permission to access the configuration at the specified LocationUri.
+ type: string
+ pattern: '^((arn):(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):(iam)::\d{12}:role[/].*)$'
+ minLength: 20
+ maxLength: 2048
+ Validators:
+ description: A list of methods for validating the configuration.
+ type: array
+ items:
+ $ref: '#/components/schemas/Validator'
+ minItems: 0
+ maxItems: 2
+ Tags:
+ description: 'Metadata to assign to the configuration profile. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.'
+ type: object
+ minProperties: 0
+ maxProperties: 50
+ 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: ListConfigurationProfiles
+ description: Lists the configuration profiles for an application.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ConfigurationProfiles'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: max_results
+ in: query
+ required: false
+ description: The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
+ schema:
+ type: integer
+ minimum: 1
+ maximum: 50
+ - name: next_token
+ in: query
+ required: false
+ description: A token to start the list. Use this token to get the next set of results.
+ schema:
+ type: string
+ minLength: 1
+ maxLength: 2048
+ - name: MaxResults
+ in: query
+ schema:
+ type: string
+ description: Pagination limit
+ required: false
+ - name: NextToken
+ in: query
+ schema:
+ type: string
+ description: Pagination token
+ required: false
+ /deploymentstrategies:
+ post:
+ operationId: CreateDeploymentStrategy
+ description: 'A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes: the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.'
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/DeploymentStrategy'
+ '480':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '481':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters: []
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ required:
+ - Name
+ - DeploymentDurationInMinutes
+ - GrowthFactor
+ - ReplicateTo
+ properties:
+ Name:
+ description: A name for the deployment strategy.
+ type: string
+ minLength: 1
+ maxLength: 64
+ Description:
+ description: A description of the deployment strategy.
+ type: string
+ minLength: 0
+ maxLength: 1024
+ DeploymentDurationInMinutes:
+ description: Total amount of time for a deployment to last.
+ type: integer
+ minimum: 0
+ maximum: 1440
+ FinalBakeTimeInMinutes:
+ description: The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
+ type: integer
+ minimum: 0
+ maximum: 1440
+ GrowthFactor:
+ description: The percentage of targets to receive a deployed configuration during each interval.
+ type: number
+ format: float
+ minimum: 1
+ maximum: 100
+ GrowthType:
+ description: 'The algorithm used to define how percentage grows over time. AWS AppConfig supports the following growth types:
Linear: For this type, AppConfig processes the deployment by dividing the total number of targets by the value specified for Step percentage. For example, a linear deployment that uses a Step percentage of 10 deploys the configuration to 10 percent of the hosts. After those deployments are complete, the system deploys the configuration to the next 10 percent. This continues until 100% of the targets have successfully received the configuration.
Exponential: For this type, AppConfig processes the deployment exponentially using the following formula: G*(2^N). In this formula, G is the growth factor specified by the user and N is the number of steps until the configuration is deployed to all targets. For example, if you specify a growth factor of 2, then the system rolls out the configuration as follows:
2*(2^0)
2*(2^1)
2*(2^2)
Expressed numerically, the deployment rolls out as follows: 2% of the targets, 4% of the targets, 8% of the targets, and continues until the configuration has been deployed to all targets.
' + type: string + enum: + - LINEAR + - EXPONENTIAL + ReplicateTo: + description: Save the deployment strategy to a Systems Manager (SSM) document. + type: string + enum: + - NONE + - SSM_DOCUMENT + Tags: + description: 'Metadata to assign to the deployment strategy. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.' + type: object + minProperties: 0 + maxProperties: 50 + 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: ListDeploymentStrategies + description: List deployment strategies. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/DeploymentStrategies' + '480': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + '481': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: max_results + in: query + required: false + description: The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results. + schema: + type: integer + minimum: 1 + maximum: 50 + - name: next_token + in: query + required: false + description: A token to start the list. Use this token to get the next set of results. + schema: + type: string + minLength: 1 + maxLength: 2048 + - name: MaxResults + in: query + schema: + type: string + description: Pagination limit + required: false + - name: NextToken + in: query + schema: + type: string + description: Pagination token + required: false + '/applications/{ApplicationId}/environments': + post: + operationId: CreateEnvironment + description: 'For each application, you define one or more environments. An environment is a logical deployment group of AppConfig targets, such as applications in aBeta or Production environment. You can also define environments for application subcomponents such as the Web, Mobile and Back-end components for your application. You can configure Amazon CloudWatch alarms for each environment. The system monitors alarms during a configuration deployment. If an alarm is triggered, the system rolls back the configuration.'
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Environment'
+ '480':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ required:
+ - Name
+ properties:
+ Name:
+ description: A name for the environment.
+ type: string
+ minLength: 1
+ maxLength: 64
+ Description:
+ description: A description of the environment.
+ type: string
+ minLength: 0
+ maxLength: 1024
+ Monitors:
+ description: Amazon CloudWatch alarms to monitor during the deployment process.
+ type: array
+ items:
+ $ref: '#/components/schemas/Monitor'
+ minItems: 0
+ maxItems: 5
+ Tags:
+ description: 'Metadata to assign to the environment. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.'
+ type: object
+ minProperties: 0
+ maxProperties: 50
+ 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: ListEnvironments
+ description: List the environments for an application.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Environments'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: max_results
+ in: query
+ required: false
+ description: The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
+ schema:
+ type: integer
+ minimum: 1
+ maximum: 50
+ - name: next_token
+ in: query
+ required: false
+ description: A token to start the list. Use this token to get the next set of results.
+ schema:
+ type: string
+ minLength: 1
+ maxLength: 2048
+ - name: MaxResults
+ in: query
+ schema:
+ type: string
+ description: Pagination limit
+ required: false
+ - name: NextToken
+ in: query
+ schema:
+ type: string
+ description: Pagination token
+ required: false
+ '/applications/{ApplicationId}/configurationprofiles/{ConfigurationProfileId}/hostedconfigurationversions#Content-Type':
+ post:
+ operationId: CreateHostedConfigurationVersion
+ description: Create a new configuration in the AppConfig configuration store.
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/HostedConfigurationVersion'
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ServiceQuotaExceededException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ServiceQuotaExceededException'
+ '482':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '483':
+ description: ConflictException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ConflictException'
+ '484':
+ description: PayloadTooLargeException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/PayloadTooLargeException'
+ '485':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: ConfigurationProfileId
+ in: path
+ required: true
+ description: The configuration profile ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: Description
+ in: header
+ required: false
+ description: A description of the configuration.
+ schema:
+ type: string
+ minLength: 0
+ maxLength: 1024
+ - name: Content-Type
+ in: header
+ required: true
+ description: 'A standard MIME type describing the format of the configuration content. For more information, see Content-Type.'
+ schema:
+ type: string
+ minLength: 1
+ maxLength: 255
+ - name: Latest-Version-Number
+ in: header
+ required: false
+ description: 'An optional locking token used to prevent race conditions from overwriting configuration updates when creating a new version. To ensure your data is not overwritten when creating multiple hosted configuration versions in rapid succession, specify the version of the latest hosted configuration version.'
+ schema:
+ type: integer
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ required:
+ - Content
+ properties:
+ Content:
+ description: The content of the configuration or the configuration data.
+ type: string
+ format: password
+ 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'
+ '/applications/{ApplicationId}':
+ delete:
+ operationId: DeleteApplication
+ description: Delete an application. Deleting an application does not delete a configuration from a host.
+ responses:
+ '204':
+ description: Success
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The ID of the application to delete.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ 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: GetApplication
+ description: Retrieve information about an application.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Application'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The ID of the application you want to get.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ patch:
+ operationId: UpdateApplication
+ description: Updates an application.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Application'
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Name:
+ description: The name of the application.
+ type: string
+ minLength: 1
+ maxLength: 64
+ Description:
+ description: A description of the application.
+ type: string
+ minLength: 0
+ maxLength: 1024
+ '/applications/{ApplicationId}/configurationprofiles/{ConfigurationProfileId}':
+ delete:
+ operationId: DeleteConfigurationProfile
+ description: Delete a configuration profile. Deleting a configuration profile does not delete a configuration from a host.
+ responses:
+ '204':
+ description: Success
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: ConflictException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ConflictException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '483':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID that includes the configuration profile you want to delete.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: ConfigurationProfileId
+ in: path
+ required: true
+ description: The ID of the configuration profile you want to delete.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ 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: GetConfigurationProfile
+ description: Retrieve information about a configuration profile.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ConfigurationProfile'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The ID of the application that includes the configuration profile you want to get.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: ConfigurationProfileId
+ in: path
+ required: true
+ description: The ID of the configuration profile you want to get.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ patch:
+ operationId: UpdateConfigurationProfile
+ description: Updates a configuration profile.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ConfigurationProfile'
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: ConfigurationProfileId
+ in: path
+ required: true
+ description: The ID of the configuration profile.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Name:
+ description: The name of the configuration profile.
+ type: string
+ minLength: 1
+ maxLength: 64
+ Description:
+ description: A description of the configuration profile.
+ type: string
+ minLength: 0
+ maxLength: 1024
+ RetrievalRoleArn:
+ description: The ARN of an IAM role with permission to access the configuration at the specified LocationUri.
+ type: string
+ pattern: '^((arn):(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):(iam)::\d{12}:role[/].*)$'
+ minLength: 20
+ maxLength: 2048
+ Validators:
+ description: A list of methods for validating the configuration.
+ type: array
+ items:
+ $ref: '#/components/schemas/Validator'
+ minItems: 0
+ maxItems: 2
+ '/deployementstrategies/{DeploymentStrategyId}':
+ delete:
+ operationId: DeleteDeploymentStrategy
+ description: Delete a deployment strategy. Deleting a deployment strategy does not delete a configuration from a host.
+ responses:
+ '204':
+ description: Success
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: DeploymentStrategyId
+ in: path
+ required: true
+ description: The ID of the deployment strategy you want to delete.
+ schema:
+ type: string
+ pattern: '(^[a-z0-9]{4,7}$|^AppConfig\.[A-Za-z0-9]{9,40}$)'
+ 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'
+ '/applications/{ApplicationId}/environments/{EnvironmentId}':
+ delete:
+ operationId: DeleteEnvironment
+ description: Delete an environment. Deleting an environment does not delete a configuration from a host.
+ responses:
+ '204':
+ description: Success
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: ConflictException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ConflictException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '483':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID that includes the environment you want to delete.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: EnvironmentId
+ in: path
+ required: true
+ description: The ID of the environment you want to delete.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ 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: GetEnvironment
+ description: 'Retrieve information about an environment. An environment is a logical deployment group of AppConfig applications, such as applications in a Production environment or in an EU_Region environment. Each configuration deployment targets an environment. You can enable one or more Amazon CloudWatch alarms for an environment. If an alarm is triggered during a deployment, AppConfig roles back the configuration.'
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Environment'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The ID of the application that includes the environment you want to get.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: EnvironmentId
+ in: path
+ required: true
+ description: The ID of the environment you wnat to get.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ patch:
+ operationId: UpdateEnvironment
+ description: Updates an environment.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Environment'
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: EnvironmentId
+ in: path
+ required: true
+ description: The environment ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Name:
+ description: The name of the environment.
+ type: string
+ minLength: 1
+ maxLength: 64
+ Description:
+ description: A description of the environment.
+ type: string
+ minLength: 0
+ maxLength: 1024
+ Monitors:
+ description: Amazon CloudWatch alarms to monitor during the deployment process.
+ type: array
+ items:
+ $ref: '#/components/schemas/Monitor'
+ minItems: 0
+ maxItems: 5
+ '/applications/{ApplicationId}/configurationprofiles/{ConfigurationProfileId}/hostedconfigurationversions/{VersionNumber}':
+ delete:
+ operationId: DeleteHostedConfigurationVersion
+ description: Delete a version of a configuration from the AppConfig configuration store.
+ responses:
+ '204':
+ description: Success
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: ConfigurationProfileId
+ in: path
+ required: true
+ description: The configuration profile ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: VersionNumber
+ in: path
+ required: true
+ description: The versions number to delete.
+ schema:
+ type: integer
+ 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: GetHostedConfigurationVersion
+ description: Get information about a specific configuration version.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/HostedConfigurationVersion'
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: ConfigurationProfileId
+ in: path
+ required: true
+ description: The configuration profile ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: VersionNumber
+ in: path
+ required: true
+ description: The version.
+ schema:
+ type: integer
+ '/applications/{Application}/environments/{Environment}/configurations/{Configuration}#client_id':
+ get:
+ operationId: GetConfiguration
+ description: 'Receive information about a configuration.
AWS AppConfig uses the value of the ClientConfigurationVersion parameter to identify the configuration version on your clients. If you don’t send ClientConfigurationVersion with each call to GetConfiguration, your clients receive the current configuration. You are charged each time your clients receive a configuration.
To avoid excess charges, we recommend that you include the ClientConfigurationVersion value with every call to GetConfiguration. This value must be saved on your client. Subsequent calls to GetConfiguration must pass this value by using the ClientConfigurationVersion parameter.
The configuration version returned in the most recent GetConfiguration response.
AWS AppConfig uses the value of the ClientConfigurationVersion parameter to identify the configuration version on your clients. If you don’t send ClientConfigurationVersion with each call to GetConfiguration, your clients receive the current configuration. You are charged each time your clients receive a configuration.
To avoid excess charges, we recommend that you include the ClientConfigurationVersion value with every call to GetConfiguration. This value must be saved on your client. Subsequent calls to GetConfiguration must pass this value by using the ClientConfigurationVersion parameter.
For more information about working with configurations, see Retrieving the Configuration in the AWS AppConfig User Guide.
' + schema: + type: string + minLength: 1 + maxLength: 1024 + 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' + '/applications/{ApplicationId}/environments/{EnvironmentId}/deployments/{DeploymentNumber}': + get: + operationId: GetDeployment + description: Retrieve information about a configuration deployment. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/Deployment' + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: ApplicationId + in: path + required: true + description: 'The ID of the application that includes the deployment you want to get. ' + schema: + type: string + pattern: '[a-z0-9]{4,7}' + - name: EnvironmentId + in: path + required: true + description: 'The ID of the environment that includes the deployment you want to get. ' + schema: + type: string + pattern: '[a-z0-9]{4,7}' + - name: DeploymentNumber + in: path + required: true + description: The sequence number of the deployment. + schema: + type: integer + 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' + delete: + operationId: StopDeployment + description: Stops a deployment. This API action works only on deployments that have a status ofDEPLOYING. This action moves the deployment to a status of ROLLED_BACK.
+ responses:
+ '202':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Deployment'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: EnvironmentId
+ in: path
+ required: true
+ description: The environment ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: DeploymentNumber
+ in: path
+ required: true
+ description: The sequence number of the deployment.
+ schema:
+ type: integer
+ '/deploymentstrategies/{DeploymentStrategyId}':
+ get:
+ operationId: GetDeploymentStrategy
+ description: 'Retrieve information about a deployment strategy. A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes: the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.'
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/DeploymentStrategy'
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ '482':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ parameters:
+ - name: DeploymentStrategyId
+ in: path
+ required: true
+ description: The ID of the deployment strategy to get.
+ schema:
+ type: string
+ pattern: '(^[a-z0-9]{4,7}$|^AppConfig\.[A-Za-z0-9]{9,40}$)'
+ 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'
+ patch:
+ operationId: UpdateDeploymentStrategy
+ description: Updates a deployment strategy.
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/DeploymentStrategy'
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: DeploymentStrategyId
+ in: path
+ required: true
+ description: The deployment strategy ID.
+ schema:
+ type: string
+ pattern: '(^[a-z0-9]{4,7}$|^AppConfig\.[A-Za-z0-9]{9,40}$)'
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Description:
+ description: A description of the deployment strategy.
+ type: string
+ minLength: 0
+ maxLength: 1024
+ DeploymentDurationInMinutes:
+ description: Total amount of time for a deployment to last.
+ type: integer
+ minimum: 0
+ maximum: 1440
+ FinalBakeTimeInMinutes:
+ description: The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
+ type: integer
+ minimum: 0
+ maximum: 1440
+ GrowthFactor:
+ description: The percentage of targets to receive a deployed configuration during each interval.
+ type: number
+ format: float
+ minimum: 1
+ maximum: 100
+ GrowthType:
+ description: 'The algorithm used to define how percentage grows over time. AWS AppConfig supports the following growth types:
Linear: For this type, AppConfig processes the deployment by increments of the growth factor evenly distributed over the deployment time. For example, a linear deployment that uses a growth factor of 20 initially makes the configuration available to 20 percent of the targets. After 1/5th of the deployment time has passed, the system updates the percentage to 40 percent. This continues until 100% of the targets are set to receive the deployed configuration.
Exponential: For this type, AppConfig processes the deployment exponentially using the following formula: G*(2^N). In this formula, G is the growth factor specified by the user and N is the number of steps until the configuration is deployed to all targets. For example, if you specify a growth factor of 2, then the system rolls out the configuration as follows:
2*(2^0)
2*(2^1)
2*(2^2)
Expressed numerically, the deployment rolls out as follows: 2% of the targets, 4% of the targets, 8% of the targets, and continues until the configuration has been deployed to all targets.
' + type: string + enum: + - LINEAR + - EXPONENTIAL + '/applications/{ApplicationId}/environments/{EnvironmentId}/deployments': + get: + operationId: ListDeployments + description: Lists the deployments for an environment. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/Deployments' + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + '482': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + parameters: + - name: ApplicationId + in: path + required: true + description: The application ID. + schema: + type: string + pattern: '[a-z0-9]{4,7}' + - name: EnvironmentId + in: path + required: true + description: The environment ID. + schema: + type: string + pattern: '[a-z0-9]{4,7}' + - name: max_results + in: query + required: false + description: The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results. + schema: + type: integer + minimum: 1 + maximum: 50 + - name: next_token + in: query + required: false + description: A token to start the list. Use this token to get the next set of results. + schema: + type: string + minLength: 1 + maxLength: 2048 + - name: MaxResults + in: query + schema: + type: string + description: Pagination limit + required: false + - name: NextToken + in: query + schema: + type: string + description: Pagination token + required: false + 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' + post: + operationId: StartDeployment + description: Starts a deployment. + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/Deployment' + '480': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '481': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '482': + description: ConflictException + content: + application/json: + schema: + $ref: '#/components/schemas/ConflictException' + '483': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + parameters: + - name: ApplicationId + in: path + required: true + description: The application ID. + schema: + type: string + pattern: '[a-z0-9]{4,7}' + - name: EnvironmentId + in: path + required: true + description: The environment ID. + schema: + type: string + pattern: '[a-z0-9]{4,7}' + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - DeploymentStrategyId + - ConfigurationProfileId + - ConfigurationVersion + properties: + DeploymentStrategyId: + description: The deployment strategy ID. + type: string + pattern: '(^[a-z0-9]{4,7}$|^AppConfig\.[A-Za-z0-9]{9,40}$)' + ConfigurationProfileId: + description: The configuration profile ID. + type: string + pattern: '[a-z0-9]{4,7}' + ConfigurationVersion: + description: The configuration version to deploy. + type: string + minLength: 1 + maxLength: 1024 + Description: + description: A description of the deployment. + type: string + minLength: 0 + maxLength: 1024 + Tags: + description: 'Metadata to assign to the deployment. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.' + type: object + minProperties: 0 + maxProperties: 50 + additionalProperties: + $ref: '#/components/schemas/TagValue' + '/applications/{ApplicationId}/configurationprofiles/{ConfigurationProfileId}/hostedconfigurationversions': + get: + operationId: ListHostedConfigurationVersions + description: View a list of configurations stored in the AppConfig configuration store by version. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/HostedConfigurationVersions' + '480': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '481': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '482': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + parameters: + - name: ApplicationId + in: path + required: true + description: The application ID. + schema: + type: string + pattern: '[a-z0-9]{4,7}' + - name: ConfigurationProfileId + in: path + required: true + description: The configuration profile ID. + schema: + type: string + pattern: '[a-z0-9]{4,7}' + - name: max_results + in: query + required: false + description: The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results. + schema: + type: integer + minimum: 1 + maximum: 50 + - name: next_token + in: query + required: false + description: 'A token to start the list. Use this token to get the next set of results. ' + schema: + type: string + minLength: 1 + maxLength: 2048 + - name: MaxResults + in: query + schema: + type: string + description: Pagination limit + required: false + - name: NextToken + in: query + schema: + type: string + description: Pagination token + required: false + 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' + '/tags/{ResourceArn}': + get: + operationId: ListTagsForResource + description: Retrieves the list of key-value tags assigned to the resource. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceTags' + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '482': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + parameters: + - name: ResourceArn + in: path + required: true + description: The resource ARN. + schema: + type: string + pattern: 'arn:(aws[a-zA-Z-]*)?:[a-z]+:([a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1})?:(\d{12})?:[a-zA-Z0-9-_/:.]+' + minLength: 20 + maxLength: 2048 + 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' + post: + operationId: TagResource + description: 'Metadata to assign to an AppConfig resource. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define. You can specify a maximum of 50 tags for a resource.' + responses: + '204': + description: Success + '480': + description: ResourceNotFoundException + content: + application/json: + schema: + $ref: '#/components/schemas/ResourceNotFoundException' + '481': + description: BadRequestException + content: + application/json: + schema: + $ref: '#/components/schemas/BadRequestException' + '482': + description: InternalServerException + content: + application/json: + schema: + $ref: '#/components/schemas/InternalServerException' + parameters: + - name: ResourceArn + in: path + required: true + description: The ARN of the resource for which to retrieve tags. + schema: + type: string + pattern: 'arn:(aws[a-zA-Z-]*)?:[a-z]+:([a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1})?:(\d{12})?:[a-zA-Z0-9-_/:.]+' + minLength: 20 + maxLength: 2048 + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - Tags + properties: + Tags: + description: 'The key-value string map. The valid character set is [a-zA-Z+-=._:/]. The tag key can be up to 128 characters and must not start withaws:. The tag value can be up to 256 characters.'
+ type: object
+ minProperties: 0
+ maxProperties: 50
+ additionalProperties:
+ $ref: '#/components/schemas/TagValue'
+ '/tags/{ResourceArn}#tagKeys':
+ delete:
+ operationId: UntagResource
+ description: Deletes a tag key and value from an AppConfig resource.
+ responses:
+ '204':
+ description: Success
+ '480':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '481':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ResourceArn
+ in: path
+ required: true
+ description: The ARN of the resource for which to remove tags.
+ schema:
+ type: string
+ pattern: 'arn:(aws[a-zA-Z-]*)?:[a-z]+:([a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1})?:(\d{12})?:[a-zA-Z0-9-_/:.]+'
+ minLength: 20
+ maxLength: 2048
+ - name: tagKeys
+ in: query
+ required: true
+ description: The tag keys to delete.
+ schema:
+ type: array
+ items:
+ $ref: '#/components/schemas/TagKey'
+ minItems: 0
+ 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'
+ '/applications/{ApplicationId}/configurationprofiles/{ConfigurationProfileId}/validators#configuration_version':
+ post:
+ operationId: ValidateConfiguration
+ description: Uses the validators in a configuration profile to validate a configuration.
+ responses:
+ '204':
+ description: Success
+ '480':
+ description: BadRequestException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/BadRequestException'
+ '481':
+ description: ResourceNotFoundException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceNotFoundException'
+ '482':
+ description: InternalServerException
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/InternalServerException'
+ parameters:
+ - name: ApplicationId
+ in: path
+ required: true
+ description: The application ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: ConfigurationProfileId
+ in: path
+ required: true
+ description: The configuration profile ID.
+ schema:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ - name: configuration_version
+ in: query
+ required: true
+ description: The version of the configuration to validate.
+ schema:
+ type: string
+ minLength: 1
+ maxLength: 1024
+ 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'
+components:
+ parameters:
+ X-Amz-Content-Sha256:
+ name: X-Amz-Content-Sha256
+ in: header
+ schema:
+ type: string
+ required: false
+ X-Amz-Date:
+ name: X-Amz-Date
+ in: header
+ schema:
+ type: string
+ required: false
+ X-Amz-Algorithm:
+ name: X-Amz-Algorithm
+ in: header
+ schema:
+ type: string
+ required: false
+ X-Amz-Credential:
+ name: X-Amz-Credential
+ in: header
+ schema:
+ type: string
+ required: false
+ X-Amz-Security-Token:
+ name: X-Amz-Security-Token
+ in: header
+ schema:
+ type: string
+ required: false
+ X-Amz-Signature:
+ name: X-Amz-Signature
+ in: header
+ schema:
+ type: string
+ required: false
+ X-Amz-SignedHeaders:
+ name: X-Amz-SignedHeaders
+ in: header
+ schema:
+ type: string
+ required: false
+ securitySchemes:
+ hmac:
+ type: apiKey
+ name: Authorization
+ in: header
+ description: Amazon Signature authorization v4
+ x-amazon-apigateway-authtype: awsSigv4
+ schemas:
+ Application:
+ type: object
+ properties:
+ Id:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The application ID.
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The application name.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: The description of the application.
+ TagValue:
+ type: string
+ maxLength: 256
+ BadRequestException: {}
+ InternalServerException: {}
+ ConfigurationProfile:
+ type: object
+ properties:
+ ApplicationId:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The application ID.
+ Id:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The configuration profile ID.
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The name of the configuration profile.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: The configuration profile description.
+ LocationUri:
+ allOf:
+ - $ref: '#/components/schemas/Uri'
+ - description: The URI location of the configuration.
+ RetrievalRoleArn:
+ allOf:
+ - $ref: '#/components/schemas/RoleArn'
+ - description: The ARN of an IAM role with permission to access the configuration at the specified LocationUri.
+ Validators:
+ allOf:
+ - $ref: '#/components/schemas/ValidatorList'
+ - description: A list of methods for validating the configuration.
+ Validator:
+ type: object
+ required:
+ - Type
+ - Content
+ properties:
+ Type:
+ allOf:
+ - $ref: '#/components/schemas/ValidatorType'
+ - description: 'AppConfig supports validators of type JSON_SCHEMA and LAMBDA '
+ Content:
+ allOf:
+ - $ref: '#/components/schemas/StringWithLengthBetween0And32768'
+ - description: Either the JSON Schema content or the Amazon Resource Name (ARN) of an AWS Lambda function.
+ description: 'A validator provides a syntactic or semantic check to ensure the configuration you want to deploy functions as intended. To validate your application configuration data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or update can only proceed when the configuration data is valid.'
+ ResourceNotFoundException: {}
+ DeploymentStrategy:
+ type: object
+ properties:
+ Id:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The deployment strategy ID.
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The name of the deployment strategy.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: The description of the deployment strategy.
+ DeploymentDurationInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: Total amount of time the deployment lasted.
+ GrowthType:
+ allOf:
+ - $ref: '#/components/schemas/GrowthType'
+ - description: The algorithm used to define how percentage grew over time.
+ GrowthFactor:
+ allOf:
+ - $ref: '#/components/schemas/Percentage'
+ - description: The percentage of targets that received a deployed configuration during each interval.
+ FinalBakeTimeInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
+ ReplicateTo:
+ allOf:
+ - $ref: '#/components/schemas/ReplicateTo'
+ - description: Save the deployment strategy to a Systems Manager (SSM) document.
+ Environment:
+ type: object
+ properties:
+ ApplicationId:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The application ID.
+ Id:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The environment ID.
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The name of the environment.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: The description of the environment.
+ State:
+ allOf:
+ - $ref: '#/components/schemas/EnvironmentState'
+ - description: 'The state of the environment. An environment can be in one of the following states: READY_FOR_DEPLOYMENT, DEPLOYING, ROLLING_BACK, or ROLLED_BACK '
+ Monitors:
+ allOf:
+ - $ref: '#/components/schemas/MonitorList'
+ - description: Amazon CloudWatch alarms monitored during the deployment.
+ Monitor:
+ type: object
+ properties:
+ AlarmArn:
+ allOf:
+ - $ref: '#/components/schemas/Arn'
+ - description: ARN of the Amazon CloudWatch alarm.
+ AlarmRoleArn:
+ allOf:
+ - $ref: '#/components/schemas/RoleArn'
+ - description: ARN of an IAM role for AppConfig to monitor AlarmArn.
+ description: Amazon CloudWatch alarms to monitor during the deployment process.
+ HostedConfigurationVersion:
+ type: object
+ properties:
+ Content:
+ allOf:
+ - $ref: '#/components/schemas/Blob'
+ - description: The content of the configuration or the configuration data.
+ ServiceQuotaExceededException: {}
+ ConflictException: {}
+ PayloadTooLargeException: {}
+ Configuration:
+ type: object
+ properties:
+ Content:
+ allOf:
+ - $ref: '#/components/schemas/Blob'
+ - description: The content of the configuration or the configuration data.
+ Deployment:
+ type: object
+ properties:
+ ApplicationId:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The ID of the application that was deployed.
+ EnvironmentId:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The ID of the environment that was deployed.
+ DeploymentStrategyId:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The ID of the deployment strategy that was deployed.
+ ConfigurationProfileId:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The ID of the configuration profile that was deployed.
+ DeploymentNumber:
+ allOf:
+ - $ref: '#/components/schemas/Integer'
+ - description: The sequence number of the deployment.
+ ConfigurationName:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The name of the configuration.
+ ConfigurationLocationUri:
+ allOf:
+ - $ref: '#/components/schemas/Uri'
+ - description: Information about the source location of the configuration.
+ ConfigurationVersion:
+ allOf:
+ - $ref: '#/components/schemas/Version'
+ - description: The configuration version that was deployed.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: The description of the deployment.
+ DeploymentDurationInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: Total amount of time the deployment lasted.
+ GrowthType:
+ allOf:
+ - $ref: '#/components/schemas/GrowthType'
+ - description: The algorithm used to define how percentage grew over time.
+ GrowthFactor:
+ allOf:
+ - $ref: '#/components/schemas/Percentage'
+ - description: The percentage of targets to receive a deployed configuration during each interval.
+ FinalBakeTimeInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
+ State:
+ allOf:
+ - $ref: '#/components/schemas/DeploymentState'
+ - description: The state of the deployment.
+ EventLog:
+ allOf:
+ - $ref: '#/components/schemas/DeploymentEvents'
+ - description: A list containing all events related to a deployment. The most recent events are displayed first.
+ PercentageComplete:
+ allOf:
+ - $ref: '#/components/schemas/Percentage'
+ - description: The percentage of targets for which the deployment is available.
+ StartedAt:
+ allOf:
+ - $ref: '#/components/schemas/Iso8601DateTime'
+ - description: The time the deployment started.
+ CompletedAt:
+ allOf:
+ - $ref: '#/components/schemas/Iso8601DateTime'
+ - description: 'The time the deployment completed. '
+ Applications:
+ type: object
+ properties:
+ Items:
+ allOf:
+ - $ref: '#/components/schemas/ApplicationList'
+ - description: The elements from this collection.
+ NextToken:
+ allOf:
+ - $ref: '#/components/schemas/NextToken'
+ - description: The token for the next set of items to return. Use this token to get the next set of results.
+ ConfigurationProfiles:
+ type: object
+ properties:
+ Items:
+ allOf:
+ - $ref: '#/components/schemas/ConfigurationProfileSummaryList'
+ - description: The elements from this collection.
+ NextToken:
+ allOf:
+ - $ref: '#/components/schemas/NextToken'
+ - description: The token for the next set of items to return. Use this token to get the next set of results.
+ DeploymentStrategies:
+ type: object
+ properties:
+ Items:
+ allOf:
+ - $ref: '#/components/schemas/DeploymentStrategyList'
+ - description: The elements from this collection.
+ NextToken:
+ allOf:
+ - $ref: '#/components/schemas/NextToken'
+ - description: The token for the next set of items to return. Use this token to get the next set of results.
+ Deployments:
+ type: object
+ properties:
+ Items:
+ allOf:
+ - $ref: '#/components/schemas/DeploymentList'
+ - description: The elements from this collection.
+ NextToken:
+ allOf:
+ - $ref: '#/components/schemas/NextToken'
+ - description: The token for the next set of items to return. Use this token to get the next set of results.
+ Environments:
+ type: object
+ properties:
+ Items:
+ allOf:
+ - $ref: '#/components/schemas/EnvironmentList'
+ - description: The elements from this collection.
+ NextToken:
+ allOf:
+ - $ref: '#/components/schemas/NextToken'
+ - description: The token for the next set of items to return. Use this token to get the next set of results.
+ HostedConfigurationVersions:
+ type: object
+ properties:
+ Items:
+ allOf:
+ - $ref: '#/components/schemas/HostedConfigurationVersionSummaryList'
+ - description: The elements from this collection.
+ NextToken:
+ allOf:
+ - $ref: '#/components/schemas/NextToken'
+ - description: The token for the next set of items to return. Use this token to get the next set of results.
+ ResourceTags:
+ type: object
+ properties:
+ Tags:
+ allOf:
+ - $ref: '#/components/schemas/TagMap'
+ - description: 'Metadata to assign to AppConfig resources. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.'
+ TagKey:
+ type: string
+ minLength: 1
+ maxLength: 128
+ Id:
+ type: string
+ pattern: '[a-z0-9]{4,7}'
+ Name:
+ type: string
+ minLength: 1
+ maxLength: 64
+ Description:
+ type: string
+ minLength: 0
+ maxLength: 1024
+ ApplicationList:
+ type: array
+ items:
+ $ref: '#/components/schemas/Application'
+ NextToken:
+ type: string
+ minLength: 1
+ maxLength: 2048
+ Arn:
+ type: string
+ pattern: 'arn:(aws[a-zA-Z-]*)?:[a-z]+:([a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1})?:(\d{12})?:[a-zA-Z0-9-_/:.]+'
+ minLength: 20
+ maxLength: 2048
+ Blob:
+ type: string
+ format: password
+ Version:
+ type: string
+ minLength: 1
+ maxLength: 1024
+ String:
+ type: string
+ Uri:
+ type: string
+ minLength: 1
+ maxLength: 2048
+ RoleArn:
+ type: string
+ pattern: '^((arn):(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):(iam)::\d{12}:role[/].*)$'
+ minLength: 20
+ maxLength: 2048
+ ValidatorList:
+ type: array
+ items:
+ $ref: '#/components/schemas/Validator'
+ minItems: 0
+ maxItems: 2
+ ValidatorTypeList:
+ type: array
+ items:
+ $ref: '#/components/schemas/ValidatorType'
+ minItems: 0
+ maxItems: 2
+ ConfigurationProfileSummary:
+ type: object
+ properties:
+ ApplicationId:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The application ID.
+ Id:
+ allOf:
+ - $ref: '#/components/schemas/Id'
+ - description: The ID of the configuration profile.
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The name of the configuration profile.
+ LocationUri:
+ allOf:
+ - $ref: '#/components/schemas/Uri'
+ - description: The URI location of the configuration.
+ ValidatorTypes:
+ allOf:
+ - $ref: '#/components/schemas/ValidatorTypeList'
+ - description: The types of validators in the configuration profile.
+ description: A summary of a configuration profile.
+ ConfigurationProfileSummaryList:
+ type: array
+ items:
+ $ref: '#/components/schemas/ConfigurationProfileSummary'
+ TagMap:
+ type: object
+ minProperties: 0
+ maxProperties: 50
+ additionalProperties:
+ $ref: '#/components/schemas/TagValue'
+ CreateApplicationRequest:
+ type: object
+ required:
+ - Name
+ title: CreateApplicationRequest
+ properties:
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: A name for the application.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: A description of the application.
+ Tags:
+ allOf:
+ - $ref: '#/components/schemas/TagMap'
+ - description: 'Metadata to assign to the application. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.'
+ CreateConfigurationProfileRequest:
+ type: object
+ required:
+ - Name
+ - LocationUri
+ title: CreateConfigurationProfileRequest
+ properties:
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: A name for the configuration profile.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: A description of the configuration profile.
+ LocationUri:
+ allOf:
+ - $ref: '#/components/schemas/Uri'
+ - description: 'A URI to locate the configuration. You can specify a Systems Manager (SSM) document, an SSM Parameter Store parameter, or an Amazon S3 object. For an SSM document, specify either the document name in the format ssm-document://<Document_name> or the Amazon Resource Name (ARN). For a parameter, specify either the parameter name in the format ssm-parameter://<Parameter_name> or the ARN. For an Amazon S3 object, specify the URI in the following format: s3://<bucket>/<objectKey> . Here is an example: s3://my-bucket/my-app/us-east-1/my-config.json'
+ RetrievalRoleArn:
+ allOf:
+ - $ref: '#/components/schemas/RoleArn'
+ - description: The ARN of an IAM role with permission to access the configuration at the specified LocationUri.
+ Validators:
+ allOf:
+ - $ref: '#/components/schemas/ValidatorList'
+ - description: A list of methods for validating the configuration.
+ Tags:
+ allOf:
+ - $ref: '#/components/schemas/TagMap'
+ - description: 'Metadata to assign to the configuration profile. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.'
+ MinutesBetween0And24Hours:
+ type: integer
+ minimum: 0
+ maximum: 1440
+ GrowthFactor:
+ type: number
+ format: float
+ minimum: 1
+ maximum: 100
+ GrowthType:
+ type: string
+ enum:
+ - LINEAR
+ - EXPONENTIAL
+ ReplicateTo:
+ type: string
+ enum:
+ - NONE
+ - SSM_DOCUMENT
+ CreateDeploymentStrategyRequest:
+ type: object
+ required:
+ - Name
+ - DeploymentDurationInMinutes
+ - GrowthFactor
+ - ReplicateTo
+ title: CreateDeploymentStrategyRequest
+ properties:
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: A name for the deployment strategy.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: A description of the deployment strategy.
+ DeploymentDurationInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: Total amount of time for a deployment to last.
+ FinalBakeTimeInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
+ GrowthFactor:
+ allOf:
+ - $ref: '#/components/schemas/GrowthFactor'
+ - description: The percentage of targets to receive a deployed configuration during each interval.
+ GrowthType:
+ allOf:
+ - $ref: '#/components/schemas/GrowthType'
+ - description: 'The algorithm used to define how percentage grows over time. AWS AppConfig supports the following growth types:
Linear: For this type, AppConfig processes the deployment by dividing the total number of targets by the value specified for Step percentage. For example, a linear deployment that uses a Step percentage of 10 deploys the configuration to 10 percent of the hosts. After those deployments are complete, the system deploys the configuration to the next 10 percent. This continues until 100% of the targets have successfully received the configuration.
Exponential: For this type, AppConfig processes the deployment exponentially using the following formula: G*(2^N). In this formula, G is the growth factor specified by the user and N is the number of steps until the configuration is deployed to all targets. For example, if you specify a growth factor of 2, then the system rolls out the configuration as follows:
2*(2^0)
2*(2^1)
2*(2^2)
Expressed numerically, the deployment rolls out as follows: 2% of the targets, 4% of the targets, 8% of the targets, and continues until the configuration has been deployed to all targets.
' + ReplicateTo: + allOf: + - $ref: '#/components/schemas/ReplicateTo' + - description: Save the deployment strategy to a Systems Manager (SSM) document. + Tags: + allOf: + - $ref: '#/components/schemas/TagMap' + - description: 'Metadata to assign to the deployment strategy. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.' + MonitorList: + type: array + items: + $ref: '#/components/schemas/Monitor' + minItems: 0 + maxItems: 5 + CreateEnvironmentRequest: + type: object + required: + - Name + title: CreateEnvironmentRequest + properties: + Name: + allOf: + - $ref: '#/components/schemas/Name' + - description: A name for the environment. + Description: + allOf: + - $ref: '#/components/schemas/Description' + - description: A description of the environment. + Monitors: + allOf: + - $ref: '#/components/schemas/MonitorList' + - description: Amazon CloudWatch alarms to monitor during the deployment process. + Tags: + allOf: + - $ref: '#/components/schemas/TagMap' + - description: 'Metadata to assign to the environment. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.' + StringWithLengthBetween1And255: + type: string + minLength: 1 + maxLength: 255 + Integer: + type: integer + CreateHostedConfigurationVersionRequest: + type: object + required: + - Content + title: CreateHostedConfigurationVersionRequest + properties: + Content: + allOf: + - $ref: '#/components/schemas/Blob' + - description: The content of the configuration or the configuration data. + DeleteApplicationRequest: + type: object + title: DeleteApplicationRequest + properties: {} + DeleteConfigurationProfileRequest: + type: object + title: DeleteConfigurationProfileRequest + properties: {} + DeploymentStrategyId: + type: string + pattern: '(^[a-z0-9]{4,7}$|^AppConfig\.[A-Za-z0-9]{9,40}$)' + DeleteDeploymentStrategyRequest: + type: object + title: DeleteDeploymentStrategyRequest + properties: {} + DeleteEnvironmentRequest: + type: object + title: DeleteEnvironmentRequest + properties: {} + DeleteHostedConfigurationVersionRequest: + type: object + title: DeleteHostedConfigurationVersionRequest + properties: {} + Percentage: + type: number + format: float + minimum: 1 + maximum: 100 + DeploymentState: + type: string + enum: + - BAKING + - VALIDATING + - DEPLOYING + - COMPLETE + - ROLLING_BACK + - ROLLED_BACK + DeploymentEvents: + type: array + items: + $ref: '#/components/schemas/DeploymentEvent' + Iso8601DateTime: + type: string + format: date-time + DeploymentEventType: + type: string + enum: + - PERCENTAGE_UPDATED + - ROLLBACK_STARTED + - ROLLBACK_COMPLETED + - BAKE_TIME_STARTED + - DEPLOYMENT_STARTED + - DEPLOYMENT_COMPLETED + TriggeredBy: + type: string + enum: + - USER + - APPCONFIG + - CLOUDWATCH_ALARM + - INTERNAL_ERROR + DeploymentEvent: + type: object + properties: + EventType: + allOf: + - $ref: '#/components/schemas/DeploymentEventType' + - description: 'The type of deployment event. Deployment event types include the start, stop, or completion of a deployment; a percentage update; the start or stop of a bake period; the start or completion of a rollback.' + TriggeredBy: + allOf: + - $ref: '#/components/schemas/TriggeredBy' + - description: 'The entity that triggered the deployment event. Events can be triggered by a user, AWS AppConfig, an Amazon CloudWatch alarm, or an internal error.' + Description: + allOf: + - $ref: '#/components/schemas/Description' + - description: 'A description of the deployment event. Descriptions include, but are not limited to, the user account or the CloudWatch alarm ARN that initiated a rollback, the percentage of hosts that received the deployment, or in the case of an internal error, a recommendation to attempt a new deployment.' + OccurredAt: + allOf: + - $ref: '#/components/schemas/Iso8601DateTime' + - description: The date and time the event occurred. + description: An object that describes a deployment event. + DeploymentSummary: + type: object + properties: + DeploymentNumber: + allOf: + - $ref: '#/components/schemas/Integer' + - description: The sequence number of the deployment. + ConfigurationName: + allOf: + - $ref: '#/components/schemas/Name' + - description: The name of the configuration. + ConfigurationVersion: + allOf: + - $ref: '#/components/schemas/Version' + - description: The version of the configuration. + DeploymentDurationInMinutes: + allOf: + - $ref: '#/components/schemas/MinutesBetween0And24Hours' + - description: Total amount of time the deployment lasted. + GrowthType: + allOf: + - $ref: '#/components/schemas/GrowthType' + - description: The algorithm used to define how percentage grows over time. + GrowthFactor: + allOf: + - $ref: '#/components/schemas/Percentage' + - description: The percentage of targets to receive a deployed configuration during each interval. + FinalBakeTimeInMinutes: + allOf: + - $ref: '#/components/schemas/MinutesBetween0And24Hours' + - description: The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back. + State: + allOf: + - $ref: '#/components/schemas/DeploymentState' + - description: The state of the deployment. + PercentageComplete: + allOf: + - $ref: '#/components/schemas/Percentage' + - description: The percentage of targets for which the deployment is available. + StartedAt: + allOf: + - $ref: '#/components/schemas/Iso8601DateTime' + - description: Time the deployment started. + CompletedAt: + allOf: + - $ref: '#/components/schemas/Iso8601DateTime' + - description: Time the deployment completed. + description: Information about the deployment. + DeploymentList: + type: array + items: + $ref: '#/components/schemas/DeploymentSummary' + DeploymentStrategyList: + type: array + items: + $ref: '#/components/schemas/DeploymentStrategy' + EnvironmentState: + type: string + enum: + - READY_FOR_DEPLOYMENT + - DEPLOYING + - ROLLING_BACK + - ROLLED_BACK + EnvironmentList: + type: array + items: + $ref: '#/components/schemas/Environment' + GetApplicationRequest: + type: object + title: GetApplicationRequest + properties: {} + GetConfigurationProfileRequest: + type: object + title: GetConfigurationProfileRequest + properties: {} + StringWithLengthBetween1And64: + type: string + minLength: 1 + maxLength: 64 + GetConfigurationRequest: + type: object + title: GetConfigurationRequest + properties: {} + GetDeploymentRequest: + type: object + title: GetDeploymentRequest + properties: {} + GetDeploymentStrategyRequest: + type: object + title: GetDeploymentStrategyRequest + properties: {} + GetEnvironmentRequest: + type: object + title: GetEnvironmentRequest + properties: {} + GetHostedConfigurationVersionRequest: + type: object + title: GetHostedConfigurationVersionRequest + properties: {} + HostedConfigurationVersionSummary: + type: object + properties: + ApplicationId: + allOf: + - $ref: '#/components/schemas/Id' + - description: The application ID. + ConfigurationProfileId: + allOf: + - $ref: '#/components/schemas/Id' + - description: The configuration profile ID. + VersionNumber: + allOf: + - $ref: '#/components/schemas/Integer' + - description: The configuration version. + Description: + allOf: + - $ref: '#/components/schemas/Description' + - description: A description of the configuration. + ContentType: + allOf: + - $ref: '#/components/schemas/StringWithLengthBetween1And255' + - description: 'A standard MIME type describing the format of the configuration content. For more information, see Content-Type.' + description: Information about the configuration. + HostedConfigurationVersionSummaryList: + type: array + items: + $ref: '#/components/schemas/HostedConfigurationVersionSummary' + MaxResults: + type: integer + minimum: 1 + maximum: 50 + ListApplicationsRequest: + type: object + title: ListApplicationsRequest + properties: {} + ListConfigurationProfilesRequest: + type: object + title: ListConfigurationProfilesRequest + properties: {} + ListDeploymentStrategiesRequest: + type: object + title: ListDeploymentStrategiesRequest + properties: {} + ListDeploymentsRequest: + type: object + title: ListDeploymentsRequest + properties: {} + ListEnvironmentsRequest: + type: object + title: ListEnvironmentsRequest + properties: {} + ListHostedConfigurationVersionsRequest: + type: object + title: ListHostedConfigurationVersionsRequest + properties: {} + ListTagsForResourceRequest: + type: object + title: ListTagsForResourceRequest + properties: {} + StartDeploymentRequest: + type: object + required: + - DeploymentStrategyId + - ConfigurationProfileId + - ConfigurationVersion + title: StartDeploymentRequest + properties: + DeploymentStrategyId: + allOf: + - $ref: '#/components/schemas/DeploymentStrategyId' + - description: The deployment strategy ID. + ConfigurationProfileId: + allOf: + - $ref: '#/components/schemas/Id' + - description: The configuration profile ID. + ConfigurationVersion: + allOf: + - $ref: '#/components/schemas/Version' + - description: The configuration version to deploy. + Description: + allOf: + - $ref: '#/components/schemas/Description' + - description: A description of the deployment. + Tags: + allOf: + - $ref: '#/components/schemas/TagMap' + - description: 'Metadata to assign to the deployment. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.' + StopDeploymentRequest: + type: object + title: StopDeploymentRequest + properties: {} + StringWithLengthBetween0And32768: + type: string + minLength: 0 + maxLength: 32768 + format: password + TagKeyList: + type: array + items: + $ref: '#/components/schemas/TagKey' + minItems: 0 + maxItems: 50 + TagResourceRequest: + type: object + required: + - Tags + title: TagResourceRequest + properties: + Tags: + allOf: + - $ref: '#/components/schemas/TagMap' + - description: 'The key-value string map. The valid character set is [a-zA-Z+-=._:/]. The tag key can be up to 128 characters and must not start withaws:. The tag value can be up to 256 characters.'
+ UntagResourceRequest:
+ type: object
+ title: UntagResourceRequest
+ properties: {}
+ UpdateApplicationRequest:
+ type: object
+ title: UpdateApplicationRequest
+ properties:
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The name of the application.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: A description of the application.
+ UpdateConfigurationProfileRequest:
+ type: object
+ title: UpdateConfigurationProfileRequest
+ properties:
+ Name:
+ allOf:
+ - $ref: '#/components/schemas/Name'
+ - description: The name of the configuration profile.
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: A description of the configuration profile.
+ RetrievalRoleArn:
+ allOf:
+ - $ref: '#/components/schemas/RoleArn'
+ - description: The ARN of an IAM role with permission to access the configuration at the specified LocationUri.
+ Validators:
+ allOf:
+ - $ref: '#/components/schemas/ValidatorList'
+ - description: A list of methods for validating the configuration.
+ UpdateDeploymentStrategyRequest:
+ type: object
+ title: UpdateDeploymentStrategyRequest
+ properties:
+ Description:
+ allOf:
+ - $ref: '#/components/schemas/Description'
+ - description: A description of the deployment strategy.
+ DeploymentDurationInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: Total amount of time for a deployment to last.
+ FinalBakeTimeInMinutes:
+ allOf:
+ - $ref: '#/components/schemas/MinutesBetween0And24Hours'
+ - description: The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
+ GrowthFactor:
+ allOf:
+ - $ref: '#/components/schemas/GrowthFactor'
+ - description: The percentage of targets to receive a deployed configuration during each interval.
+ GrowthType:
+ allOf:
+ - $ref: '#/components/schemas/GrowthType'
+ - description: 'The algorithm used to define how percentage grows over time. AWS AppConfig supports the following growth types:
Linear: For this type, AppConfig processes the deployment by increments of the growth factor evenly distributed over the deployment time. For example, a linear deployment that uses a growth factor of 20 initially makes the configuration available to 20 percent of the targets. After 1/5th of the deployment time has passed, the system updates the percentage to 40 percent. This continues until 100% of the targets are set to receive the deployed configuration.
Exponential: For this type, AppConfig processes the deployment exponentially using the following formula: G*(2^N). In this formula, G is the growth factor specified by the user and N is the number of steps until the configuration is deployed to all targets. For example, if you specify a growth factor of 2, then the system rolls out the configuration as follows:
2*(2^0)
2*(2^1)
2*(2^2)
Expressed numerically, the deployment rolls out as follows: 2% of the targets, 4% of the targets, 8% of the targets, and continues until the configuration has been deployed to all targets.
' + UpdateEnvironmentRequest: + type: object + title: UpdateEnvironmentRequest + properties: + Name: + allOf: + - $ref: '#/components/schemas/Name' + - description: The name of the environment. + Description: + allOf: + - $ref: '#/components/schemas/Description' + - description: A description of the environment. + Monitors: + allOf: + - $ref: '#/components/schemas/MonitorList' + - description: Amazon CloudWatch alarms to monitor during the deployment process. + ValidateConfigurationRequest: + type: object + title: ValidateConfigurationRequest + properties: {} + ValidatorType: + type: string + enum: + - JSON_SCHEMA + - LAMBDA +security: + - hmac: [] diff --git a/fixtures/immutable/specifications/v3/bbcCom.yaml b/fixtures/immutable/specifications/v3/bbcCom.yaml new file mode 100644 index 00000000000..791519b1868 --- /dev/null +++ b/fixtures/immutable/specifications/v3/bbcCom.yaml @@ -0,0 +1,5955 @@ +openapi: 3.0.0 +servers: + - url: https://programmes.api.bbc.com +info: + contact: + email: nitro@bbc.co.uk + name: Open Nitro Project + url: http://developer.bbc.co.uk/ + description: BBC Nitro is the BBC's application programming interface (API) for + BBC Programmes Metadata. + license: + name: Nitro Public License + url: https://github.com/Mermade/bbcparse/wiki/Nitro-Public-License + termsOfService: http://www.bbc.co.uk/terms/ + title: BBC Nitro API + version: 1.0.0 + x-apiClientRegistration: + url: https://developer.bbc.co.uk/user/register + x-apisguru-categories: + - media + - open_data + x-logo: + url: https://github.com/Mermade/bbcparse/blob/master/nitroApi/nitro-logo.png?raw=true + x-origin: + - contentType: application/json + converter: + url: https://github.com/mermade/bbcparse + version: 1.3.1 + url: http://programmes.api.bbc.com/nitro/api + - converter: + url: https://github.com/mermade/oas-kit + version: 7.0.4 + format: openapi + url: https://raw.githubusercontent.com/Mermade/bbcparse/master/nitroApi/openapi.yaml + version: "3.0" + x-providerName: bbc.com + x-tags: + - BBC + - programme information + - iPlayer + - iPlayer Radio + x-unofficialSpec: true +externalDocs: + description: Nitro for developers + url: https://developer.bbc.co.uk/nitro +security: + - api_key: [] +tags: + - description: Nitro data feeds + name: feeds + - description: Nitro metadata + name: schema + - description: Nitro Raw + name: Raw +paths: + /: + get: + description: Get API definition + operationId: getAPI + parameters: [] + responses: + "200": + description: Metadata response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Get API definition + tags: + - schema + /availabilities: + get: + description: Discover details of on-demand availability for programmes and their + versions + operationId: listAvailability + parameters: + - description: > + Sorts: + + * scheduled_start: sort chronologically by scheduled start time/date, ascending + in: query + name: sort + required: false + schema: + enum: + - scheduled_start + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - ascending + - descending + type: string + - description: filter for subset of availabilities + in: query + name: availability + required: false + schema: + items: + enum: + - available + type: string + type: array + - description: filter for subset of availabilities that have PID as ancestor + in: query + name: descendants_of + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of availabilities with media set + in: query + name: media_set + required: false + schema: + items: + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for availabilities in given territory + in: query + name: territory + required: false + schema: + items: + enum: + - uk + - nonuk + - world + type: string + type: array + - description: Turn on debug information (undocumented) + in: query + name: debug + required: false + schema: + type: boolean + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Discover details of on-demand availability for programmes and their + versions + tags: + - feeds + /broadcasts: + get: + description: Fetch metadata about linear Broadcasts and Services, allowing the + generation of Television and Radio schedules and other datasets for + broadcast items. Use /schedules instead of this feed as it is more + efficient. Broadcasts will be deprecated in the future. + operationId: listBroadcasts + parameters: + - description: > + Sorts: + + * start_date: sort chronologically by scheduled start time/date, ascending + in: query + name: sort + required: false + schema: + enum: + - start_date + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - ascending + - descending + type: string + - description: | + Mixins: + * titles: return ancestor programme titles + in: query + name: mixin + required: false + schema: + items: + enum: + - titles + type: string + type: array + - description: filter for subset of broadcasts that have given authority + in: query + name: authority + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts that are descendants of the given + programme PID + in: query + name: descendants_of + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of broadcasts that end on or later than the + specified datetime + in: query + name: end_from + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts that end on or earlier than the + specified datetime + in: query + name: end_to + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts that are classified in the given + format ID + in: query + name: format + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts that are classified in the given + genre ID + in: query + name: genre + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts that have given identifier + in: query + name: id + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts with the given item performed on it + in: query + name: item + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for subset of broadcasts that have given contributor + in: query + name: people + required: false + schema: + type: string + - description: filter for subset of broadcasts having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of broadcasts matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: filter for subset of broadcasts that start on the specified day + (BBC time) + in: query + name: schedule_day + required: false + schema: + format: date + type: string + - description: filter for subset of broadcasts that start on or after the + specified day (BBC time) + in: query + name: schedule_day_from + required: false + schema: + format: date + type: string + - description: filter for subset of broadcasts that start on or before the + specified day (BBC time) + in: query + name: schedule_day_to + required: false + schema: + format: date + type: string + - description: filter for subset of broadcasts with given service master brand + in: query + name: service_master_brand + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts that are on the specified linear + service + in: query + name: sid + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts that start on or later than the + specified datetime + in: query + name: start_from + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts that start on or earlier than the + specified datetime + in: query + name: start_to + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts with given PID as their parent + version + in: query + name: version + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Build schedules and find metadata for TV and radio broadcasts + tags: + - feeds + /groups: + get: + description: Long-lived curated collections of programmes and more, including + Collections, Seasons, Franchises and Galleries + operationId: listGroups + parameters: + - description: | + Sorts: + * pid: sort alphabetically by PID + in: query + name: sort + required: false + schema: + enum: + - pid + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - descending + type: string + - description: > + Mixins: + + * alternate_images: mixin to return the alternate images for a group + + * group_for: mixin to return links to programme entities that group belongs to + + * images: mixin to add image information for a group + + * related_links: mixin to return related links for the group + in: query + name: mixin + required: false + schema: + items: + enum: + - alternate_images + - group_for + - images + - related_links + type: string + type: array + - description: filter for groups related to given programme or its descendants + in: query + name: for_descendants_of + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for subset of groups directly related to a given programme + in: query + name: for_programme + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for subset of groups which belong to the given group pid + in: query + name: group + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for subset of groups that have the given group type + in: query + name: group_type + required: false + schema: + items: + enum: + - collection + - franchise + - gallery + - season + type: string + type: array + - description: filter for subset of groups which contain an entity with the given + pid as a member + in: query + name: member + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for groups by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for groups by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of seasons, collections, galleries or franchises + having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of groups matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: Control return of embargoed items (undocumented) + in: query + name: embargoed + required: false + schema: + enum: + - include + - exclude + - only + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: "Find metadata for curated groups: seasons, collections, galleries or + franchises" + tags: + - feeds + /images: + get: + description: Find metadata for images, particularly those in galleries + operationId: listImages + parameters: + - description: | + Sorts: + * group_position: sort numerically by position, ascending only + * pid: sort alphabetically by PID + in: query + name: sort + required: false + schema: + enum: + - group_position + - pid + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - ascending + - descending + type: string + - description: filter for images belonging to the given group (i.e. Gallery) + in: query + name: group + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for images by type + in: query + name: image_type + required: false + schema: + items: + enum: + - standard + - podcast + - store + - portrait + - letterbox + type: string + type: array + - description: filter for alternate images by entity PID + in: query + name: is_alternate_image_for + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for images by entity PID + in: query + name: is_image_for + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for images by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for images by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of images having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of images matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: Control return of embargoed items (undocumented) + in: query + name: embargoed + required: false + schema: + enum: + - include + - exclude + - only + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Find metadata for images + tags: + - feeds + /items: + get: + description: "Look inside programmes to find segments: chapters, tracks and more" + operationId: listItems + parameters: + - description: | + Sorts: + * pid: sort by pid, descending + in: query + name: sort + required: false + schema: + enum: + - pid + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - descending + type: string + - description: > + Mixins: + + * contributions: mixin to return information about contributors to items + + * images: mixin to add image information for an item + + * offset: mixin to return programme segment offsets, works in conjunction with programme filter + + * play_event: mixin to return programme segment events, works in conjunction with programme or segment_event filters + in: query + name: mixin + required: false + schema: + items: + enum: + - contributions + - images + - offset + - play_event + type: string + type: array + - description: filter for subset of items that have an ID issued by the given + authority + in: query + name: authority + required: false + schema: + type: string + - description: filter for subset of items having given ID + in: query + name: id + required: false + schema: + items: + type: string + type: array + - description: filter for subset of items that have given an ID of the given type + in: query + name: id_type + required: false + schema: + type: string + - description: filter for specific type(s) of items + in: query + name: item_type + required: false + schema: + items: + enum: + - chapter + - highlight + - music + - speech + - other + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for items by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for items by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of items that have specified person involved + in: query + name: people + required: false + schema: + type: string + - description: filter for subset of items matching one of the given PIDs + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of items that are part of the given programme + in: query + name: programme + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for subset of items matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: filter for item with the given segment_event + in: query + name: segment_event + required: false + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: "Look inside programmes to find segments: chapters, tracks and more" + tags: + - feeds + /master_brands: + get: + description: List all Master Brands + operationId: listMasterbrands + parameters: + - description: | + Sorts: + * mid: sort by mid, ascending + in: query + name: sort + required: false + schema: + enum: + - mid + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - ascending + type: string + - description: | + Mixins: + * images: mixin to add image information for a masterbrand + in: query + name: mixin + required: false + schema: + items: + enum: + - images + type: string + type: array + - description: filter for subset of masterbrands that have given identifier + in: query + name: mid + required: false + schema: + items: + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for masterbrands by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for masterbrands by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of masterbrands matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: List all Master Brands + tags: + - feeds + /people: + get: + description: The People feed allows you to search for the people and groups that + contribute to programmes. This is the starting point for cast and crew + credits, as well as finding contributors using external IDs (such as + Wikipedia URLs) + operationId: listPeople + parameters: + - description: filter for subset of people that have an ID issued by the given + authority + in: query + name: authority + required: false + schema: + type: string + - description: filter for people who have an external identifier + in: query + name: has_external_id + required: false + schema: + items: + enum: + - "true" + - "false" + type: string + type: array + - description: filter for subset of people having given ID + in: query + name: id + required: false + schema: + items: + type: string + type: array + - description: filter for subset of people that have given an ID of the given type + in: query + name: id_type + required: false + schema: + type: string + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for people by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for people by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of people having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of people that have contributed to the given + programme pid + in: query + name: programme + required: false + schema: + type: string + - description: filter for subset of people matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: "Find the people behind and in programmes: cast, crew, guests and more" + tags: + - feeds + /pips: + get: + description: Look inside pips entities + operationId: listPips + parameters: + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for subset of programmes matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Look inside pips entities + tags: + - feeds + /programme_details: + get: + description: Exposes programme information for a single pid + operationId: listProgrammeDetails + parameters: + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: Filter for programme information by partner PID + in: query + name: partner_pid + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: Filter for programme information for the provided PID + in: query + name: pid + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Exposes programme information for a single pid + tags: + - feeds + /programmes: + get: + description: Fetch metadata about Programmes (brands, series, episodes, clips). + By applying different filter restrictions this feed can be used in many + ways, for example to retrieve all series belonging to a brand, all the + episodes and/or clips for a specific series, or any TLEO objects for a + masterbrand. Other filters permit restricting to specific formats and/or + genres, and you can request specific versions (for example Signed or + Audio-Described). Parameters may be combined in any way suitable for + your application. + operationId: listProgrammes + parameters: + - description: > + Sorts: + + * group_position: sort numerically by position in group, ascending + + * pid: sort alphabetically by PID, descending + + * position: sort numerically by position, ascending + + * promotion: sort by promotion rank, ascending + + * release_date: sort chronologically by release date, descending + + * relevance: sort by weighting of search term (use with q parameter) + + * scheduled_start: sort chronologically by scheduled start time/date, ascending + + * strict_title: sort alphabetically by title, ascending + + * title: sort by title librarian style (ignoring leading 'The', 'A', etc), ascending + + * tree: sort by root pid and then preorder tree sort. Requires entities to have release date. + in: query + name: sort + required: false + schema: + enum: + - group_position + - pid + - position + - promotion + - release_date + - relevance + - scheduled_start + - strict_title + - title + - tree + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - ascending + - descending + type: string + - description: > + Mixins: + + * alternate_images: mixin to return the alternate images for a programme + + * ancestor_titles: mixin to return ancestor programme titles + + * availability: mixin to return programme availability information + + * available_simulcasts: mixin to return information about programmes that are currently available as simulcasts + + * available_versions: mixin to return information about programmes that are currently available on demand + + * available_webcasts: mixin to return information about programmes that are currently available as webcasts + + * contributions: mixin to return information about contributors to a programme + + * duration: mixin to return original version duration in programme concept entities + + * genre_groupings: mixin to return list of genre groupings + + * genre_groups: mixin to return list of genre groups + + * images: mixin to add image information for a programme + + * is_embeddable: mixin to add embeddable information for a programme + + * previous_next: mixin to return the programmes which appear before and after a programme (as determined by the sort applied in the request) + + * programme_type: mixin to return the programme type + + * related_links: mixin to return information about related links to a programme + + * titles: mixin to return ancestor programme titles + + * versions_availability: mixin to return information about programmes that are currently available + in: query + name: mixin + required: false + schema: + items: + enum: + - alternate_images + - ancestor_titles + - availability + - available_simulcasts + - available_versions + - available_webcasts + - contributions + - duration + - genre_groupings + - genre_groups + - images + - is_embeddable + - previous_next + - programme_type + - related_links + - titles + - versions_availability + type: string + type: array + - description: filter for subset of programmes that are audio-described + in: query + name: audio_described + required: false + schema: + items: + enum: + - "true" + - "false" + type: string + type: array + - description: filter for subset of programmes that have availability + in: query + name: availability + required: false + schema: + items: + enum: + - available + - pending + type: string + type: array + - description: additional filter when availability=available + in: query + name: availability_entity_type + required: false + schema: + items: + enum: + - episode + - clip + type: string + type: array + - deprecated: true + description: filter for subset of programmes that are available after or at the + specified datetime + in: query + name: availability_from + required: false + schema: + format: date-time + type: string + - description: filter for a subset of programmes that are available for a given type + in: query + name: availability_type + required: false + schema: + items: + enum: + - ondemand + - webcast + - simulcast + type: string + type: array + - description: filter for subset of programmes that have PID as immediate parent + in: query + name: children_of + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of programmes that have PID as ancestor + in: query + name: descendants_of + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of programmes that have given duration + in: query + name: duration + required: false + schema: + items: + enum: + - short + - medium + - long + type: string + type: array + - description: filter for subset of programmes that have given entity type + in: query + name: entity_type + required: false + schema: + items: + enum: + - brand + - series + - episode + - clip + type: string + type: array + - description: filter for subset of programmes with format + in: query + name: format + required: false + schema: + items: + type: string + type: array + - description: filter for subset of programmes with genre + in: query + name: genre + required: false + schema: + items: + type: string + type: array + - description: filter for subset of programmes which belong to the given group pid + in: query + name: group + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for subset of programmes with title beginning with initial + letter librarian style (ignoring leading 'The', 'An' (Welsh), etc) + 0-9 a-z + in: query + name: initial_letter + required: false + schema: + maxLength: 1 + minLength: 1 + type: string + - description: Programmes with (librarian) titles whose initial letter is + equal/before given letter. Use with initial_letter_start for a range + in: query + name: initial_letter_end + required: false + schema: + maxLength: 1 + minLength: 1 + type: string + - description: Programmes with (librarian) titles whose initial letter is + equal/after given letter. Use with initial_letter_end for range. + in: query + name: initial_letter_start + required: false + schema: + maxLength: 1 + minLength: 1 + type: string + - description: filter for subset of programmes with title beginning with initial + letter + in: query + name: initial_letter_strict + required: false + schema: + items: + maxLength: 1 + minLength: 1 + type: string + type: array + - description: filter for subset of programmes with linked to versions which have + the given item pids + in: query + name: item + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of programmes with master_brand + in: query + name: master_brand + required: false + schema: + items: + type: string + type: array + - description: filter for subset of programmes with media set + in: query + name: media_set + required: false + schema: + type: string + - description: filter for subset of programmes with media type + in: query + name: media_type + required: false + schema: + items: + enum: + - audio + - audio_video + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for programmes by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for programmes by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for a subset of programmes that are of the given payment_type + in: query + name: payment_type + required: false + schema: + items: + enum: + - free + - bbcstore + - uscansvod + type: string + type: array + - description: filter for subset of programmes with contributions by given people + PID + in: query + name: people + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for subset of programmes having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of programmes which are promoted for given service + in: query + name: promoted_for + required: false + schema: + type: string + - description: filter for subset of programmes matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: filter for subset of programmes that are signed + in: query + name: signed + required: false + schema: + items: + enum: + - exclusive + - inclusive + - exclude + type: string + type: array + - description: filter for subset of programmes with tag + in: query + name: tag_name + required: false + schema: + type: string + - description: filter for subset of programmes with a tag + in: query + name: tag_scheme + required: false + schema: + type: string + - description: filter for subset of programmes that are TLEOs + in: query + name: tleo + required: false + schema: + items: + enum: + - "true" + - "false" + type: string + type: array + - description: filter for subset of programmes with given PID as one of their + versions + in: query + name: version + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: Control return of embargoed items (undocumented) + in: query + name: embargoed + required: false + schema: + enum: + - include + - exclude + - only + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: "Start here for programmes metadata: Brands, Series, Episodes and Clips" + tags: + - feeds + /promotions: + get: + description: Details of short-term editorially curated "promotions", for + instance those programmes featured on iPlayer today + operationId: listPromotions + parameters: + - description: > + Mixins: + + * related_links: mixin to return information about related links to a promotion + in: query + name: mixin + required: false + schema: + items: + enum: + - related_links + type: string + type: array + - description: filter for subset of promotions belonging to a given context + in: query + name: context + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for promotions by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for promotions by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of promotions having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of promotions having given promoted by + in: query + name: promoted_by + required: false + schema: + items: + type: string + type: array + - description: filter for subset of promotions having given promoted for + in: query + name: promoted_for + required: false + schema: + items: + type: string + type: array + - description: filter for subset of promotions matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: filter for subset of promotions with status + in: query + name: status + required: false + schema: + items: + enum: + - current + type: string + type: array + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Discover metadata for content promotions + tags: + - feeds + /schedules: + get: + description: "Dates, Times, Schedules: when and where are programmes being shown?" + operationId: listSchedules + parameters: + - description: > + Sorts: + + * start_date: sort chronologically by scheduled start time/date, ascending + in: query + name: sort + required: false + schema: + enum: + - start_date + type: string + - description: Sort direction + in: query + name: sort_direction + required: false + schema: + enum: + - ascending + - descending + type: string + - description: | + Mixins: + * ancestor_titles: return ancestor programme titles + * images: mixin to add image information for broadcasts and webcasts + * titles: return ancestor programme titles + in: query + name: mixin + required: false + schema: + items: + enum: + - ancestor_titles + - images + - titles + type: string + type: array + - description: filter for subset of broadcasts and webcasts that have given + authority + in: query + name: authority + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts and webcasts that are descendants + of the given programme PID + in: query + name: descendants_of + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of broadcasts and webcasts that end on or later + than the specified datetime + in: query + name: end_from + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts and webcasts that end on or earlier + than the specified datetime + in: query + name: end_to + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts and webcasts that are classified in + the given format ID + in: query + name: format + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts and webcasts that are classified in + the given genre ID + in: query + name: genre + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts and webcasts that have programmes + in the given group + in: query + name: group + required: false + schema: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + - description: filter for subset of broadcasts and webcasts that have given + identifier + in: query + name: id + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts and webcasts that have given id type + in: query + name: id_type + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts and webcasts with the given item + performed on it + in: query + name: item + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for broadcasts and webcasts by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for broadcasts and webcasts by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of broadcasts and webcasts that have given + contributor + in: query + name: people + required: false + schema: + type: string + - description: filter for subset of broadcasts and webcasts having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of broadcasts and webcasts matching supplied + keyword/phrase (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: filter to show either only repeats or non-repeats + in: query + name: repeat + required: false + schema: + type: boolean + - description: filter for subset of broadcasts and webcasts that start on the + specified day (BBC time) + in: query + name: schedule_day + required: false + schema: + format: date + type: string + - description: filter for subset of broadcasts and webcasts that start on or after + the specified day (BBC time) + in: query + name: schedule_day_from + required: false + schema: + format: date + type: string + - description: filter for subset of broadcasts and webcasts that start on or + before the specified day (BBC time) + in: query + name: schedule_day_to + required: false + schema: + format: date + type: string + - description: filter for subset of broadcasts and webcasts with given service + master brand + in: query + name: service_master_brand + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts and webcasts that are on the + specified linear service + in: query + name: sid + required: false + schema: + items: + type: string + type: array + - description: filter for subset of broadcasts and webcasts that start on or later + than the specified datetime + in: query + name: start_from + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts and webcasts that start on or + earlier than the specified datetime + in: query + name: start_to + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts and webcasts with given PID as + their parent version + in: query + name: version + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Build schedules and find metadata for TV and radio broadcasts and + webcasts + tags: + - feeds + /schema: + get: + description: Get Schema definition + operationId: getXSD + parameters: [] + responses: + "200": + description: Metadata response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Get Schema definition + tags: + - schema + /services: + get: + description: The services feed exposes the linear broadcast "services" from + PIPs. These are the actual services which broadcast programmes (eg + bbc_one_oxford is the service for BBC One in Oxford). + operationId: listServices + parameters: + - description: Return services that end on or later than the specified datetime + in: query + name: end_from + required: false + schema: + format: date-time + type: string + - description: filter for subset of broadcasts that end on or earlier than the + specified datetime + in: query + name: end_to + required: false + schema: + format: date-time + type: string + - description: filter for services by masterbrand MID + in: query + name: mid + required: false + schema: + items: + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for services by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for services by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of services matching supplied keyword/phrase + (boolean operators permitted) + in: query + name: q + required: false + schema: + type: string + - description: filter for specified type of linear services + in: query + name: service_type + required: false + schema: + items: + enum: + - Interactive + - Local Radio + - Master Brand Only + - National Radio + - On Demand + - Regional Radio + - Simulcast + - TV + - Web Only + - Webcast + type: string + type: array + - description: filter for specified linear service + in: query + name: sid + required: false + schema: + items: + type: string + type: array + - description: Return services that start on or later than the specified datetime + in: query + name: start_from + required: false + schema: + format: date-time + type: string + - description: Return services that start earlier than the specified datetime + in: query + name: start_to + required: false + schema: + format: date-time + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: Information about the linear services used for broadcast transmissions + tags: + - feeds + "/v1/brands/{pid}": + get: + description: Get raw brand + operationId: Get_Raw_brand + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw brand + tags: + - Raw + "/v1/brands/{pid}/franchises/": + get: + description: Get raw brand franchises + operationId: Get_Raw_brand franchises + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw brand franchise + tags: + - Raw + "/v1/episodes/{pid}": + get: + description: Get raw episode + operationId: Get_Raw_episode + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw episode + tags: + - Raw + "/v1/episodes/{pid}/ancestors/": + get: + description: Get raw ancestors + operationId: Get_Raw_ancestors + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw ancestors + tags: + - Raw + "/v1/episodes/{pid}/formats/": + get: + description: Get raw formats + operationId: Get_Raw_formats + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw formats + tags: + - Raw + "/v1/episodes/{pid}/genre_groups/": + get: + description: Get raw genre groups + operationId: Get_Raw_genre_groups + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw genre groups + tags: + - Raw + "/v1/images/{pid}": + get: + description: Get raw image + operationId: Get_Raw_image + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw image + tags: + - Raw + "/v1/master_brands/{mbid}": + get: + description: Get raw masterbrand + operationId: Get_Raw_masterbrand + parameters: + - in: path + name: mbid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw masterbrand + tags: + - Raw + "/v1/promotions/{pid}": + get: + description: Get raw promotion + operationId: Get_Raw_promotion + parameters: + - in: path + name: pid + required: true + schema: + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + summary: Get raw promotion + tags: + - Raw + /versions: + get: + description: 'The versions feed exposes editorial "Versions" of programmes. + These are concepts used to capture different presentations of an overall + programme: for example, versions of a programme may include one with + sign language, one with audio description, one edited for content and + more. Versions are also important to understand for broadcasts: a linear + broadcast or an ondemand is always of a specific version, not merely of + a programme.' + operationId: listVersions + parameters: + - description: filter for subset of versions that have availability + in: query + name: availability + required: false + schema: + items: + enum: + - available + type: string + type: array + - description: filter for subset of versions having given programme PID + in: query + name: descendants_of + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for subset of versions with availability in the given media + set + in: query + name: media_set + required: false + schema: + items: + type: string + type: array + - description: which page of results to return + in: query + name: page + required: false + schema: + default: 1 + minimum: 1 + type: integer + - description: number of results in each page + in: query + name: page_size + required: false + schema: + default: 10 + maximum: 300 + type: integer + - description: filter for versions by partner ID + in: query + name: partner_id + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for versions by partner PID + in: query + name: partner_pid + required: false + schema: + items: + default: s0000001 + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: filter for a subset of versions that are of the given payment_type + in: query + name: payment_type + required: false + schema: + items: + enum: + - free + - bbcstore + - uscansvod + type: string + type: array + - description: filter for subset of versions having given PID + in: query + name: pid + required: false + schema: + items: + minLength: 8 + pattern: ^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$ + type: string + type: array + - description: Control return of embargoed items (undocumented) + in: query + name: embargoed + required: false + schema: + enum: + - include + - exclude + - only + type: string + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/nitro" + application/xml: + schema: + $ref: "#/components/schemas/nitro" + description: Nitro response + default: + content: + application/json: + schema: + $ref: "#/components/schemas/ErrorModel" + application/xml: + schema: + $ref: "#/components/schemas/ErrorModel" + description: Unexpected error + summary: "Metadata on editorial programme versions: original, signed, + audio-described, etc" + tags: + - feeds +components: + schemas: + ErrorModel: + properties: + fault: + properties: + detail: + properties: + errorcode: + type: string + type: object + faultString: + type: string + type: object + type: object + accurate_programme_time: + $ref: "#/components/schemas/dateRange" + accurate_time: + $ref: "#/components/schemas/broadcastTime" + actual_start: + format: date-time + type: string + advertising_allowed: + pattern: "[a-z0-9_]+" + type: string + affected_by: + additionalProperties: false + properties: + filter: + items: + additionalProperties: false + properties: + description: + type: string + filter: + items: + additionalProperties: false + properties: + description: + type: string + name: + type: string + required: + - name + - description + type: object + type: array + name: + type: string + required: + - name + - description + type: object + type: array + type: object + alternate_images_mixin: + additionalProperties: false + properties: + alternate_images: + additionalProperties: false + properties: + alternate_image: + items: + additionalProperties: false + properties: + alternate_images: + additionalProperties: false + properties: + alternate_image: + items: + additionalProperties: false + properties: + href: + type: string + template_url: + type: string + type: + type: string + required: + - template_url + type: object + type: array + type: object + href: + type: string + template_url: + type: string + type: + type: string + required: + - template_url + - alternate_images + type: object + type: array + type: object + required: + - alternate_images + type: object + ancestor_titles: + additionalProperties: false + properties: + brand: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + episode: + additionalProperties: false + properties: + brand: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + containers_title: + $ref: "#/components/schemas/containers_title" + episode: + additionalProperties: false + properties: + containers_title: + $ref: "#/components/schemas/containers_title" + pid: + $ref: "#/components/schemas/pid" + presentation_title: + $ref: "#/components/schemas/presentation_title" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + pid: + $ref: "#/components/schemas/pid" + presentation_title: + $ref: "#/components/schemas/presentation_title" + series: + items: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + maxItems: 5 + type: array + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + series: + items: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + maxItems: 5 + type: array + type: object + ancestors: + $ref: "#/components/schemas/reference" + ancestors_titles: + additionalProperties: false + properties: + brand: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + episode: + additionalProperties: false + properties: + brand: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + containers_title: + $ref: "#/components/schemas/containers_title" + episode: + additionalProperties: false + properties: + containers_title: + $ref: "#/components/schemas/containers_title" + pid: + $ref: "#/components/schemas/pid" + presentation_title: + $ref: "#/components/schemas/presentation_title" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + pid: + $ref: "#/components/schemas/pid" + presentation_title: + $ref: "#/components/schemas/presentation_title" + series: + items: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + maxItems: 5 + type: array + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + series: + items: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + title: + $ref: "#/components/schemas/title" + required: + - pid + type: object + maxItems: 5 + type: array + type: object + availability: + additionalProperties: false + properties: + accurate_programme_time: + $ref: "#/components/schemas/accurate_programme_time" + actual_start: + $ref: "#/components/schemas/actual_start" + availability-debug: + $ref: "#/components/schemas/availability-debug" + availability_of: + items: + $ref: "#/components/schemas/availability_of" + type: array + availability_type: + $ref: "#/components/schemas/availability_type" + media_availability_time: + $ref: "#/components/schemas/media_availability_time" + media_set: + items: + $ref: "#/components/schemas/media_set" + type: array + revocation_status: + $ref: "#/components/schemas/revocation_status" + scheduled_time: + $ref: "#/components/schemas/scheduled_time" + status: + $ref: "#/components/schemas/status" + required: + - status + - availability_type + type: object + availability-debug: + additionalProperties: false + properties: + availability_of: + $ref: "#/components/schemas/pidReference" + media_profile_groups: + $ref: "#/components/schemas/media_profile_groups" + service: + $ref: "#/components/schemas/serviceReference" + territory: + type: string + required: + - availability_of + type: object + availability_mixin: + additionalProperties: false + properties: + availability: + items: + additionalProperties: false + properties: + status: + $ref: "#/components/schemas/status" + version_types: + additionalProperties: false + properties: + version_type: + items: + additionalProperties: false + properties: + end: + format: date-time + type: string + id: + type: string + start: + format: date-time + type: string + version_type: + items: + additionalProperties: false + properties: + availability: + items: + additionalProperties: false + properties: + status: + $ref: "#/components/schemas/status" + version_types: + additionalProperties: false + properties: + version_type: + items: + additionalProperties: false + properties: + end: + format: date-time + type: string + id: + type: string + start: + format: date-time + type: string + version_type: + items: + additionalProperties: false + properties: + end: + format: date-time + type: string + id: + type: string + start: + format: date-time + type: string + type: object + minItems: 1 + type: array + required: + - version_type + type: object + minItems: 1 + type: array + required: + - version_type + type: object + required: + - status + - version_types + type: object + type: array + end: + format: date-time + type: string + id: + type: string + start: + format: date-time + type: string + type: object + minItems: 1 + type: array + required: + - version_type + type: object + minItems: 1 + type: array + required: + - version_type + type: object + required: + - status + - version_types + type: object + type: array + type: object + availability_of: + additionalProperties: false + properties: + href: + type: string + pid: + $ref: "#/components/schemas/pid" + result_type: + type: string + type: + type: string + required: + - result_type + - pid + - href + type: object + availability_type: + enum: + - ondemand + - simulcast + - webcast + available_media_sets: + additionalProperties: false + properties: + media_sets: + additionalProperties: false + properties: + media_set: + items: + additionalProperties: false + properties: + "#text": + type: string + media_sets: + additionalProperties: false + properties: + media_set: + items: + additionalProperties: false + properties: + "#text": + type: string + type: object + minItems: 1 + type: array + required: + - media_set + type: object + type: object + minItems: 1 + type: array + required: + - media_set + type: object + type: object + available_mixins: + additionalProperties: false + properties: + availabilities: + additionalProperties: false + properties: + availabilities: + additionalProperties: false + properties: + availability: + items: + additionalProperties: false + properties: + accurate_end: + format: date-time + type: string + accurate_start: + format: date-time + type: string + available_versions_media_sets: + $ref: "#/components/schemas/available_versions_media_sets" + media_availability_end: + format: date-time + type: string + media_availability_start: + format: date-time + type: string + payment_type: + type: string + scheduled_end: + format: date-time + type: string + scheduled_start: + format: date-time + type: string + status: + type: string + type: + type: string + required: + - available_versions_media_sets + type: object + minItems: 1 + type: array + type: + type: string + required: + - availability + type: object + availability: + items: + additionalProperties: false + properties: + accurate_end: + format: date-time + type: string + accurate_start: + format: date-time + type: string + available_versions_media_sets: + $ref: "#/components/schemas/available_versions_media_sets" + media_availability_end: + format: date-time + type: string + media_availability_start: + format: date-time + type: string + payment_type: + type: string + scheduled_end: + format: date-time + type: string + scheduled_start: + format: date-time + type: string + status: + type: string + type: + type: string + required: + - available_versions_media_sets + type: object + minItems: 1 + type: array + type: + type: string + required: + - availability + - availabilities + type: object + required: + - availabilities + type: object + available_simulcasts: + additionalProperties: false + properties: + available: + type: integer + available_versions_element: + $ref: "#/components/schemas/available_versions_element" + required: + - available_versions_element + - available + type: object + available_versions: + additionalProperties: false + properties: + available: + type: integer + available_versions_element: + $ref: "#/components/schemas/available_versions_element" + required: + - available_versions_element + - available + type: object + available_versions_element: + additionalProperties: false + properties: + version: + items: + additionalProperties: false + properties: + available_mixins: + $ref: "#/components/schemas/available_mixins" + competition_warning: + type: boolean + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + guidance_warnings: + $ref: "#/components/schemas/guidance_warnings" + pid: + $ref: "#/components/schemas/pid" + types: + items: + additionalProperties: false + properties: + type: + items: + type: string + type: array + type: object + minItems: 1 + type: array + version: + items: + additionalProperties: false + properties: + available_mixins: + $ref: "#/components/schemas/available_mixins" + competition_warning: + type: boolean + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + guidance_warnings: + $ref: "#/components/schemas/guidance_warnings" + pid: + $ref: "#/components/schemas/pid" + types: + items: + additionalProperties: false + properties: + type: + items: + type: string + type: array + type: object + minItems: 1 + type: array + required: + - types + type: object + type: array + required: + - types + type: object + type: array + type: object + available_versions_media_sets: + additionalProperties: false + properties: + media_sets: + additionalProperties: false + properties: + media_set: + items: + additionalProperties: false + properties: + actual_start: + format: date-time + type: string + name: + type: string + territories: + additionalProperties: false + properties: + media_sets: + additionalProperties: false + properties: + media_set: + items: + additionalProperties: false + properties: + actual_start: + format: date-time + type: string + name: + type: string + territories: + additionalProperties: false + properties: + territory: + items: + type: string + type: array + type: object + required: + - name + type: object + minItems: 1 + type: array + required: + - media_set + type: object + territory: + items: + type: string + type: array + type: object + required: + - name + type: object + minItems: 1 + type: array + required: + - media_set + type: object + type: object + available_webcasts: + additionalProperties: false + properties: + available: + type: integer + available_versions_element: + $ref: "#/components/schemas/available_versions_element" + required: + - available_versions_element + - available + type: object + brand: + additionalProperties: false + properties: + alternate_images_mixin: + $ref: "#/components/schemas/alternate_images_mixin" + availability_mixin: + $ref: "#/components/schemas/availability_mixin" + contributions_mixin: + $ref: "#/components/schemas/contributions_mixin" + embargoed: + $ref: "#/components/schemas/embargoed" + expected_child_count: + $ref: "#/components/schemas/expected_child_count" + franchises: + $ref: "#/components/schemas/franchises" + genre_groupings: + $ref: "#/components/schemas/genre_groupings" + identifiers: + $ref: "#/components/schemas/identifiers" + image_link: + $ref: "#/components/schemas/image_link" + images_mixin: + $ref: "#/components/schemas/images_mixin" + is_embeddable: + $ref: "#/components/schemas/is_embeddable" + items_for: + $ref: "#/components/schemas/items_for" + master_brand_link: + $ref: "#/components/schemas/master_brand_link" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + previous_next_mixin: + $ref: "#/components/schemas/previous_next_mixin" + programme_formats: + $ref: "#/components/schemas/programme_formats" + programme_type: + $ref: "#/components/schemas/programme_type" + related_links: + $ref: "#/components/schemas/related_links" + release_date_group: + $ref: "#/components/schemas/release_date_group" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + updated_time: + $ref: "#/components/schemas/updated_time" + uri: + $ref: "#/components/schemas/uri" + required: + - pid + - partner + - updated_time + - embargoed + type: object + broadcast: + additionalProperties: false + properties: + ancestor_titles: + $ref: "#/components/schemas/ancestor_titles" + ancestors_titles: + $ref: "#/components/schemas/ancestors_titles" + broadcast_of: + items: + $ref: "#/components/schemas/broadcast_of" + type: array + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + image_link: + $ref: "#/components/schemas/image_link" + images_mixin: + $ref: "#/components/schemas/images_mixin" + is_audio_described: + $ref: "#/components/schemas/is_audio_described" + is_blanked: + $ref: "#/components/schemas/is_blanked" + is_critical: + $ref: "#/components/schemas/is_critical" + is_repeat: + $ref: "#/components/schemas/is_repeat" + is_simulcast: + $ref: "#/components/schemas/is_simulcast" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + published_time: + $ref: "#/components/schemas/published_time" + service: + $ref: "#/components/schemas/serviceReference" + tx_time: + $ref: "#/components/schemas/tx_time" + updated_time: + $ref: "#/components/schemas/updated_time" + required: + - pid + - partner + type: object + broadcastTime: + allOf: + - $ref: "#/components/schemas/dateRange" + - additionalProperties: true + properties: + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + type: object + broadcast_of: + $ref: "#/components/schemas/pidReference" + broadcaster: + additionalProperties: false + properties: + href: + type: string + result_type: + type: string + sid: + $ref: "#/components/schemas/sid" + required: + - href + - sid + - result_type + type: object + caption: + type: string + catalogue_number: + maxLength: 32 + minLength: 1 + type: string + chapter: + $ref: "#/components/schemas/item" + clip: + additionalProperties: false + properties: + advertising_allowed: + $ref: "#/components/schemas/advertising_allowed" + alternate_images_mixin: + $ref: "#/components/schemas/alternate_images_mixin" + ancestor_titles: + $ref: "#/components/schemas/ancestor_titles" + ancestors: + $ref: "#/components/schemas/ancestors" + ancestors_titles: + $ref: "#/components/schemas/ancestors_titles" + availability_mixin: + $ref: "#/components/schemas/availability_mixin" + caption: + $ref: "#/components/schemas/caption" + clip_of: + $ref: "#/components/schemas/clip_of" + contributions_mixin: + $ref: "#/components/schemas/contributions_mixin" + embargoed: + $ref: "#/components/schemas/embargoed" + genre_groupings: + $ref: "#/components/schemas/genre_groupings" + genre_groups: + $ref: "#/components/schemas/genre_groups" + identifiers: + $ref: "#/components/schemas/identifiers" + image_link: + $ref: "#/components/schemas/image_link" + images_mixin: + $ref: "#/components/schemas/images_mixin" + is_embeddable: + $ref: "#/components/schemas/is_embeddable" + items_for: + $ref: "#/components/schemas/items_for" + master_brand_link: + $ref: "#/components/schemas/master_brand_link" + media_type: + $ref: "#/components/schemas/media_type" + original_version_duration: + $ref: "#/components/schemas/original_version_duration" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + previous_next_mixin: + $ref: "#/components/schemas/previous_next_mixin" + programme_formats: + $ref: "#/components/schemas/programme_formats" + related_links: + $ref: "#/components/schemas/related_links" + release_date_group: + $ref: "#/components/schemas/release_date_group" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + updated_time: + $ref: "#/components/schemas/updated_time" + uri: + $ref: "#/components/schemas/uri" + versions_mixin: + $ref: "#/components/schemas/versions_mixin" + required: + - pid + - partner + - updated_time + - embargoed + - advertising_allowed + type: object + clip_of: + $ref: "#/components/schemas/pidReference" + code: + type: string + collection: + $ref: "#/components/schemas/group-body" + competition_warning: + type: boolean + containers_title: + type: string + context: + additionalProperties: false + properties: + cascades_to_descendants: + type: boolean + href: + type: string + pid: + $ref: "#/components/schemas/pid" + result_type: + type: string + required: + - pid + - result_type + type: object + contributions_mixin: + additionalProperties: false + properties: + contributions: + additionalProperties: false + properties: + contributions: + additionalProperties: false + properties: + contributions_mixin_contribution: + items: + $ref: "#/components/schemas/contributions_mixin_contribution" + type: array + href: + type: string + type: object + contributions_mixin_contribution: + items: + $ref: "#/components/schemas/contributions_mixin_contribution" + type: array + href: + type: string + required: + - contributions + type: object + required: + - contributions + type: object + contributions_mixin_contribution: + additionalProperties: false + properties: + contribution: + additionalProperties: false + properties: + character_name: + type: string + contribution: + additionalProperties: false + properties: + character_name: + type: string + contributions_mixin_contributor: + $ref: "#/components/schemas/contributions_mixin_contributor" + credit_role: + additionalProperties: false + properties: + "#text": + type: string + id: + type: string + type: object + type: object + contributions_mixin_contributor: + $ref: "#/components/schemas/contributions_mixin_contributor" + credit_role: + additionalProperties: false + properties: + "#text": + type: string + id: + type: string + type: object + required: + - contribution + type: object + required: + - contribution + type: object + contributions_mixin_contributor: + additionalProperties: false + properties: + contributor: + additionalProperties: false + properties: + contributions_mixin_contributor_name: + $ref: "#/components/schemas/contributions_mixin_contributor_name" + contributor: + additionalProperties: false + properties: + contributions_mixin_contributor_name: + $ref: "#/components/schemas/contributions_mixin_contributor_name" + href: + type: string + type: + $ref: "#/components/schemas/type" + type: object + href: + type: string + type: + $ref: "#/components/schemas/type" + required: + - contributor + type: object + required: + - contributor + type: object + contributions_mixin_contributor_name: + additionalProperties: false + properties: + name: + additionalProperties: false + properties: + family: + type: string + given: + type: string + name: + additionalProperties: false + properties: + family: + type: string + given: + type: string + presentation: + type: string + title: + type: string + type: object + presentation: + type: string + title: + type: string + required: + - name + type: object + required: + - name + type: object + contributor: + additionalProperties: false + properties: + contributor_name: + $ref: "#/components/schemas/contributor_name" + contributor_to: + items: + $ref: "#/components/schemas/contributor_to" + type: array + disambiguation: + $ref: "#/components/schemas/disambiguation" + href: + type: string + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + type: + $ref: "#/components/schemas/type" + required: + - pid + - partner + type: object + contributor_name: + additionalProperties: false + properties: + name: + additionalProperties: false + properties: + family: + type: string + given: + type: string + lang: + type: string + name: + additionalProperties: false + properties: + family: + type: string + given: + type: string + lang: + type: string + presentation: + type: string + title: + type: string + type: object + presentation: + type: string + title: + type: string + required: + - name + type: object + required: + - name + type: object + contributor_to: + additionalProperties: false + properties: + href: + type: string + result_type: + type: string + required: + - result_type + - href + type: object + credits_time: + additionalProperties: false + properties: + squeeze_end: + format: date-time + type: string + squeeze_start: + format: date-time + type: string + type: object + data: + additionalProperties: false + properties: + datum: + $ref: "#/components/schemas/datum" + type: object + dateRange: + additionalProperties: false + properties: + end: + format: date-time + type: string + start: + format: date-time + type: string + type: object + date_range: + $ref: "#/components/schemas/dateRange" + datum: + type: string + dependency_on: + additionalProperties: false + properties: + filter: + type: string + value: + type: string + type: object + deprecated: + additionalProperties: false + properties: + deprecated_since: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + name: + type: string + replaced_by: + type: string + replacement_type: + type: string + type: + type: string + required: + - name + - type + - deprecated_since + type: object + deprecatedReferenceElement: + allOf: + - $ref: "#/components/schemas/referenceAttributes" + - $ref: "#/components/schemas/deprecationAttributes" + deprecationAttributes: + additionalProperties: false + properties: + deprecated: + type: boolean + deprecated_since: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + replaced_by: + type: string + required: + - deprecated + - deprecated_since + - replaced_by + type: object + deprecations: + additionalProperties: false + properties: + deprecated: + items: + $ref: "#/components/schemas/deprecated" + type: array + type: object + description: + type: string + dimensions: + additionalProperties: false + properties: + height: + type: integer + width: + type: integer + type: object + disambiguation: + type: string + embargoed: + enum: + - "true" + - "false" + end: + format: date-time + type: string + end_time: + format: date-time + type: string + episode: + additionalProperties: false + properties: + advertising_allowed: + $ref: "#/components/schemas/advertising_allowed" + alternate_images_mixin: + $ref: "#/components/schemas/alternate_images_mixin" + ancestor_titles: + $ref: "#/components/schemas/ancestor_titles" + ancestors: + $ref: "#/components/schemas/ancestors" + ancestors_titles: + $ref: "#/components/schemas/ancestors_titles" + availability_mixin: + $ref: "#/components/schemas/availability_mixin" + contributions_mixin: + $ref: "#/components/schemas/contributions_mixin" + embargoed: + $ref: "#/components/schemas/embargoed" + episode_of: + $ref: "#/components/schemas/episode_of" + genre_groupings: + $ref: "#/components/schemas/genre_groupings" + genre_groups: + $ref: "#/components/schemas/genre_groups" + has_guidance: + $ref: "#/components/schemas/has_guidance" + identifiers: + $ref: "#/components/schemas/identifiers" + image_link: + $ref: "#/components/schemas/image_link" + images_mixin: + $ref: "#/components/schemas/images_mixin" + is_embeddable: + $ref: "#/components/schemas/is_embeddable" + is_stacked: + $ref: "#/components/schemas/is_stacked" + items_for: + $ref: "#/components/schemas/items_for" + master_brand_link: + $ref: "#/components/schemas/master_brand_link" + media_type: + $ref: "#/components/schemas/media_type" + original_version_duration: + $ref: "#/components/schemas/original_version_duration" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + presentation_title: + $ref: "#/components/schemas/presentation_title" + previous_next_mixin: + $ref: "#/components/schemas/previous_next_mixin" + programme_formats: + $ref: "#/components/schemas/programme_formats" + programme_type: + $ref: "#/components/schemas/programme_type" + related_links: + $ref: "#/components/schemas/related_links" + release_date_group: + $ref: "#/components/schemas/release_date_group" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + updated_time: + $ref: "#/components/schemas/updated_time" + uri: + $ref: "#/components/schemas/uri" + versions_mixin: + $ref: "#/components/schemas/versions_mixin" + required: + - pid + - partner + - updated_time + - embargoed + - advertising_allowed + type: object + episode_of: + $ref: "#/components/schemas/pidReference" + error: + additionalProperties: false + properties: + code: + $ref: "#/components/schemas/code" + data: + $ref: "#/components/schemas/data" + error-name: + $ref: "#/components/schemas/error-name" + expr: + $ref: "#/components/schemas/expr" + format-string: + $ref: "#/components/schemas/format-string" + message: + $ref: "#/components/schemas/message" + retryable: + $ref: "#/components/schemas/retryable" + xquery-version: + $ref: "#/components/schemas/xquery-version" + required: + - code + - error-name + - xquery-version + - message + - format-string + - retryable + - expr + - data + type: object + error-name: + type: string + errors: + additionalProperties: false + properties: + error: + $ref: "#/components/schemas/error" + type: object + expected_child_count: + type: integer + expr: + type: string + feed: + additionalProperties: false + properties: + deprecations: + $ref: "#/components/schemas/deprecations" + filters: + $ref: "#/components/schemas/filters" + href: + type: string + mixins: + $ref: "#/components/schemas/mixins" + name: + type: string + rel: + type: string + release_status: + $ref: "#/components/schemas/release_status_type" + sorts: + $ref: "#/components/schemas/sorts" + title: + type: string + required: + - href + - name + - rel + - title + type: object + feeds: + additionalProperties: false + properties: + deployment_root: + type: string + deprecations: + $ref: "#/components/schemas/deprecations" + feed: + items: + $ref: "#/components/schemas/feed" + type: array + type: object + filter: + additionalProperties: false + properties: + default: + type: string + depends_on: + type: string + deprecated: + type: boolean + deprecated_since: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + guaranteed_until: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + max_value: + type: integer + min_value: + type: integer + multiple_values: + type: boolean + name: + type: string + option: + items: + $ref: "#/components/schemas/option" + type: array + prefer: + type: string + prohibits: + items: + $ref: "#/components/schemas/prohibits" + type: array + release_status: + $ref: "#/components/schemas/release_status_type" + replaced_by: + type: string + required: + type: boolean + title: + type: string + type: + type: string + required: + - name + - title + - type + type: object + filters: + additionalProperties: false + properties: + filter: + items: + $ref: "#/components/schemas/filter" + type: array + unstable_filters: + $ref: "#/components/schemas/unstable_filters" + type: object + focus_point: + additionalProperties: false + properties: + x: + type: integer + y: + type: integer + type: object + for_programme: + additionalProperties: false + properties: + href: + type: string + type: object + for_programmes: + additionalProperties: false + properties: + for_programme: + items: + $ref: "#/components/schemas/for_programme" + type: array + type: object + format: + additionalProperties: false + properties: + "#text": + type: string + format_id: + type: string + type: object + format-string: + type: string + franchise: + $ref: "#/components/schemas/group-body" + franchises: + $ref: "#/components/schemas/reference" + gallery: + $ref: "#/components/schemas/group-body" + genre: + additionalProperties: false + properties: + "#text": + type: string + id: + type: string + type: + type: string + type: object + genreGroupingsType: + additionalProperties: false + properties: + genre_group: + items: + $ref: "#/components/schemas/genre_group" + type: array + type: object + genreGroupsType: + allOf: + - $ref: "#/components/schemas/deprecatedReferenceElement" + - additionalProperties: true + properties: + genre_group: + items: + $ref: "#/components/schemas/genre_group" + type: array + type: object + genre_group: + additionalProperties: false + properties: + genres: + additionalProperties: false + properties: + genre: + items: + $ref: "#/components/schemas/genre" + type: array + type: object + id: + type: string + type: + type: string + required: + - genres + type: object + genre_groupings: + $ref: "#/components/schemas/genreGroupingsType" + genre_groups: + $ref: "#/components/schemas/genreGroupsType" + group-body: + additionalProperties: false + properties: + alternate_images_mixin: + $ref: "#/components/schemas/alternate_images_mixin" + embargoed: + $ref: "#/components/schemas/embargoed" + for_programmes: + $ref: "#/components/schemas/for_programmes" + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + images_mixin: + $ref: "#/components/schemas/images_mixin" + master_brand_link: + $ref: "#/components/schemas/master_brand_link" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + related_links: + $ref: "#/components/schemas/related_links" + scheduled: + $ref: "#/components/schemas/scheduled" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + updated_time: + $ref: "#/components/schemas/updated_time" + url_key: + $ref: "#/components/schemas/url_key" + required: + - pid + - embargoed + - partner + - updated_time + type: object + guidance_warnings: + additionalProperties: false + properties: + warnings: + additionalProperties: false + properties: + warning_items: + $ref: "#/components/schemas/warning_items" + warning_texts: + $ref: "#/components/schemas/warning_texts" + warnings: + additionalProperties: false + properties: + warning_items: + $ref: "#/components/schemas/warning_items" + warning_texts: + $ref: "#/components/schemas/warning_texts" + type: object + type: object + type: object + has_guidance: + type: boolean + highlight: + $ref: "#/components/schemas/item" + id: + additionalProperties: false + properties: + "#text": + type: string + authority: + type: string + type: + type: string + type: object + identifier: + additionalProperties: false + properties: + "#text": + type: string + authority: + type: string + type: + type: string + type: object + identifiers: + additionalProperties: false + properties: + identifier: + items: + $ref: "#/components/schemas/identifier" + minItems: 1 + type: array + required: + - identifier + type: object + ids: + additionalProperties: false + properties: + id: + items: + $ref: "#/components/schemas/id" + minItems: 1 + type: array + required: + - id + type: object + image: + additionalProperties: false + properties: + author: + type: string + embargoed: + $ref: "#/components/schemas/embargoed" + identifiers: + $ref: "#/components/schemas/identifiers" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + shoot_date: + format: date-time + type: string + source_asset: + $ref: "#/components/schemas/source_asset" + synopses: + $ref: "#/components/schemas/synopses" + template_url: + type: string + title: + $ref: "#/components/schemas/title" + type: + type: string + required: + - pid + - embargoed + - partner + type: object + image_link: + additionalProperties: false + properties: + image: + additionalProperties: false + anyOf: + - $ref: "#/components/schemas/deprecationAttributes" + - properties: + image: + additionalProperties: false + properties: + pid: + $ref: "#/components/schemas/pid" + template_url: + type: string + required: + - template_url + type: object + pid: + $ref: "#/components/schemas/pid" + template_url: + type: string + required: + - template_url + - image + type: object + required: + - image + type: object + images_mixin: + additionalProperties: false + properties: + images: + additionalProperties: false + properties: + image: + additionalProperties: false + properties: + href: + type: string + images: + additionalProperties: false + properties: + image: + additionalProperties: false + properties: + href: + type: string + inherited_from: + additionalProperties: false + properties: + href: + type: string + result_type: + type: string + type: object + template_url: + type: string + type: + type: string + required: + - template_url + type: object + type: object + inherited_from: + additionalProperties: false + properties: + href: + type: string + result_type: + type: string + type: object + template_url: + type: string + type: + type: string + required: + - template_url + - images + type: object + type: object + required: + - images + type: object + is_audio_described: + type: boolean + is_blanked: + type: boolean + is_concrete: + type: boolean + is_critical: + type: boolean + is_downloadable: + type: boolean + is_embeddable: + type: boolean + is_external: + type: boolean + is_repeat: + type: boolean + is_signed: + type: boolean + is_simulcast: + type: boolean + is_stacked: + type: boolean + is_streamable: + type: boolean + item: + additionalProperties: false + properties: + catalogue_number: + $ref: "#/components/schemas/catalogue_number" + contributions_mixin: + $ref: "#/components/schemas/contributions_mixin" + duration: + format: float + type: number + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + images_mixin: + $ref: "#/components/schemas/images_mixin" + item_of: + $ref: "#/components/schemas/item_of" + music_code: + $ref: "#/components/schemas/music_code" + offsets: + $ref: "#/components/schemas/offsets" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + play_events: + $ref: "#/components/schemas/play_events" + publisher: + $ref: "#/components/schemas/publisher" + record_label: + $ref: "#/components/schemas/record_label" + recording_date: + $ref: "#/components/schemas/recording_date" + release_title: + $ref: "#/components/schemas/release_title" + snippet_url: + $ref: "#/components/schemas/snippet_url" + source_media: + $ref: "#/components/schemas/source_media" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + track_number: + $ref: "#/components/schemas/track_number" + track_side: + $ref: "#/components/schemas/track_side" + type: + type: string + updated_time: + $ref: "#/components/schemas/updated_time" + required: + - pid + - partner + type: object + item_of: + $ref: "#/components/schemas/reference" + items_for: + $ref: "#/components/schemas/reference" + long: + type: string + master_brand: + additionalProperties: false + properties: + colour: + type: string + competition_warning: + additionalProperties: false + properties: + href: + type: string + pid: + $ref: "#/components/schemas/pid" + required: + - href + - pid + type: object + ident: + type: string + identifiers: + $ref: "#/components/schemas/identifiers" + image_link: + $ref: "#/components/schemas/image_link" + images_mixin: + $ref: "#/components/schemas/images_mixin" + master_brand_date_range: + additionalProperties: false + properties: + end: + format: date-time + type: string + start: + format: date-time + type: string + type: object + mid: + $ref: "#/components/schemas/mid" + name: + $ref: "#/components/schemas/name" + partner: + $ref: "#/components/schemas/partner" + position: + $ref: "#/components/schemas/position" + synopses: + additionalProperties: false + properties: + long: + $ref: "#/components/schemas/long" + medium: + $ref: "#/components/schemas/medium" + short: + $ref: "#/components/schemas/short" + type: object + title: + $ref: "#/components/schemas/title" + url_key: + type: string + required: + - mid + - partner + type: object + master_brand_link: + additionalProperties: false + properties: + master_brand: + additionalProperties: false + properties: + href: + type: string + master_brand: + additionalProperties: false + properties: + href: + type: string + mid: + $ref: "#/components/schemas/mid" + result_type: + type: string + required: + - href + - mid + - result_type + type: object + mid: + $ref: "#/components/schemas/mid" + result_type: + type: string + required: + - href + - mid + - result_type + - master_brand + type: object + required: + - master_brand + type: object + media_availability_time: + $ref: "#/components/schemas/dateRange" + media_profile_group: + additionalProperties: false + properties: + "#text": + type: string + context: + type: string + pid: + $ref: "#/components/schemas/pid" + platform: + type: string + territory: + type: string + transport: + type: string + type: object + media_profile_groups: + additionalProperties: false + properties: + media_profile_group: + items: + $ref: "#/components/schemas/media_profile_group" + type: array + type: object + media_set: + type: string + media_type: + enum: + - Video + - Audio + medium: + type: string + message: + type: string + mid: + type: string + mixin: + additionalProperties: false + properties: + affected_by: + items: + $ref: "#/components/schemas/affected_by" + type: array + dependency_on: + items: + $ref: "#/components/schemas/dependency_on" + type: array + depends_on: + type: string + deprecated: + type: boolean + deprecated_since: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + guaranteed_until: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + href: + type: string + name: + type: string + prohibits: + items: + $ref: "#/components/schemas/prohibits" + type: array + release_status: + $ref: "#/components/schemas/release_status_type" + replaced_by: + type: string + title: + type: string + required: + - name + - title + type: object + mixins: + additionalProperties: false + properties: + mixin: + items: + $ref: "#/components/schemas/mixin" + type: array + unstable_mixins: + $ref: "#/components/schemas/unstable_mixins" + type: object + music: + $ref: "#/components/schemas/item" + music_code: + maxLength: 8 + minLength: 1 + type: string + name: + type: string + next: + additionalProperties: false + properties: + href: + type: string + required: + - href + type: object + nitro: + additionalProperties: true + properties: + deprecations: + $ref: "#/components/schemas/deprecations" + filters: + $ref: "#/components/schemas/filters" + mixins: + $ref: "#/components/schemas/mixins" + pagination: + $ref: "#/components/schemas/pagination" + results: + $ref: "#/components/schemas/results" + sorts: + $ref: "#/components/schemas/sorts" + offset_in: + additionalProperties: false + properties: + href: + type: string + offset: + type: integer + position: + type: number + programme: + $ref: "#/components/schemas/pid" + version: + $ref: "#/components/schemas/pid" + required: + - programme + - version + - href + type: object + offsets: + additionalProperties: false + properties: + offset_in: + items: + $ref: "#/components/schemas/offset_in" + type: array + type: object + option: + additionalProperties: false + properties: + href: + type: string + release_status: + $ref: "#/components/schemas/release_status_type" + title: + type: string + value: + type: string + required: + - value + - title + type: object + original_version_duration: + additionalProperties: false + properties: + version: + additionalProperties: false + properties: + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + href: + type: string + pid: + $ref: "#/components/schemas/pid" + version: + additionalProperties: false + properties: + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + href: + type: string + pid: + $ref: "#/components/schemas/pid" + required: + - pid + - href + type: object + required: + - pid + - href + type: object + type: object + other: + $ref: "#/components/schemas/item" + pagination: + additionalProperties: false + properties: + next: + $ref: "#/components/schemas/next" + previous: + $ref: "#/components/schemas/previous" + type: object + partner: + $ref: "#/components/schemas/pid" + pid: + pattern: ([a-z0-9\.\-]+|.*PID.*) + type: string + pidReference: + additionalProperties: false + properties: + href: + type: string + pid: + $ref: "#/components/schemas/pid" + position: + type: integer + result_type: + type: string + required: + - pid + - result_type + type: object + play_event: + additionalProperties: false + properties: + offset: + type: integer + pid: + $ref: "#/components/schemas/pid" + played_in_links: + items: + $ref: "#/components/schemas/played_in_links" + type: array + position: + type: number + synopses: + $ref: "#/components/schemas/synopses" + title: + type: string + required: + - pid + type: object + play_events: + additionalProperties: false + properties: + play_event: + items: + $ref: "#/components/schemas/play_event" + type: array + type: object + played_in_links: + additionalProperties: false + properties: + played_in: + additionalProperties: false + properties: + href: + type: string + played_in: + additionalProperties: false + properties: + href: + type: string + result_type: + type: string + type: object + result_type: + type: string + type: object + type: object + position: + type: integer + presentation_title: + type: string + previous: + additionalProperties: false + properties: + href: + type: string + required: + - href + type: object + previous_next_mixin: + additionalProperties: false + properties: + previous_next: + additionalProperties: false + properties: + next: + $ref: "#/components/schemas/reference" + previous: + $ref: "#/components/schemas/reference" + previous_next: + additionalProperties: false + properties: + next: + $ref: "#/components/schemas/reference" + previous: + $ref: "#/components/schemas/reference" + type: object + required: + - previous_next + type: object + required: + - previous_next + type: object + priority: + type: integer + programme_formats: + additionalProperties: false + properties: + format: + items: + $ref: "#/components/schemas/format" + minItems: 1 + type: array + required: + - format + type: object + programme_type: + additionalProperties: false + properties: + value: + type: string + required: + - value + type: object + prohibits: + additionalProperties: false + properties: + filter: + items: + additionalProperties: false + properties: + name: + type: string + required: + - name + type: object + type: array + mixin: + items: + additionalProperties: false + properties: + filter: + items: + additionalProperties: false + properties: + name: + type: string + required: + - name + type: object + type: array + mixin: + items: + additionalProperties: false + properties: + name: + type: string + required: + - name + type: object + type: array + name: + type: string + required: + - name + type: object + type: array + type: object + promoted_by: + type: string + promoted_for: + type: string + promotion: + additionalProperties: false + properties: + context: + $ref: "#/components/schemas/context" + end_time: + $ref: "#/components/schemas/end_time" + identifiers: + $ref: "#/components/schemas/identifiers" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + priority: + $ref: "#/components/schemas/priority" + promoted_by: + $ref: "#/components/schemas/promoted_by" + promoted_for: + $ref: "#/components/schemas/promoted_for" + promotion_of: + $ref: "#/components/schemas/promotion_of" + related_links: + $ref: "#/components/schemas/related_links" + start_time: + $ref: "#/components/schemas/start_time" + status: + $ref: "#/components/schemas/status" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + updated_time: + $ref: "#/components/schemas/updated_time" + uri: + $ref: "#/components/schemas/uri" + url: + $ref: "#/components/schemas/url" + required: + - pid + - partner + - updated_time + type: object + promotion_of: + $ref: "#/components/schemas/pidReference" + publication_rights: + additionalProperties: false + properties: + "#text": + type: string + context: + type: string + platform: + type: string + territory: + type: string + transport: + type: string + type: object + published_time: + $ref: "#/components/schemas/broadcastTime" + publisher: + maxLength: 255 + minLength: 1 + type: string + record_label: + maxLength: 255 + minLength: 1 + type: string + recording_date: + maxLength: 10 + minLength: 4 + type: string + reference: + allOf: + - $ref: "#/components/schemas/referenceAttributes" + - additionalProperties: true + properties: + href_deprecated: + type: boolean + result_type_deprecated: + type: boolean + type: object + referenceAttributes: + additionalProperties: false + properties: + href: + type: string + result_type: + type: string + required: + - href + - result_type + type: object + region: + type: string + related_link: + additionalProperties: false + properties: + availability: + additionalProperties: false + properties: + end: + format: date-time + type: string + start: + format: date-time + type: string + type: object + is_external: + $ref: "#/components/schemas/is_external" + pid: + $ref: "#/components/schemas/pid" + position: + $ref: "#/components/schemas/position" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + type: + $ref: "#/components/schemas/type" + uri: + $ref: "#/components/schemas/uri" + required: + - pid + type: object + related_links: + additionalProperties: false + properties: + related_link: + items: + $ref: "#/components/schemas/related_link" + type: array + type: object + release_date_group: + additionalProperties: false + properties: + release_date: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + release_year: + pattern: "[0-9]{4}" + type: string + release_year_month: + pattern: "[0-9]{4}-[0-9]{2}" + type: string + type: object + release_status_type: + enum: + - alpha + - beta + - supported + - deprecated + release_title: + maxLength: 255 + minLength: 1 + type: string + results: + additionalProperties: false + properties: + availability: + $ref: "#/components/schemas/availability" + brand: + $ref: "#/components/schemas/brand" + broadcast: + $ref: "#/components/schemas/broadcast" + chapter: + $ref: "#/components/schemas/chapter" + clip: + $ref: "#/components/schemas/clip" + collection: + $ref: "#/components/schemas/collection" + contributor: + $ref: "#/components/schemas/contributor" + episode: + $ref: "#/components/schemas/episode" + franchise: + $ref: "#/components/schemas/franchise" + gallery: + $ref: "#/components/schemas/gallery" + highlight: + $ref: "#/components/schemas/highlight" + image: + $ref: "#/components/schemas/image" + master_brand: + $ref: "#/components/schemas/master_brand" + more_than: + type: integer + music: + $ref: "#/components/schemas/music" + other: + $ref: "#/components/schemas/other" + page: + type: integer + page_size: + type: integer + promotion: + $ref: "#/components/schemas/promotion" + season: + $ref: "#/components/schemas/season" + series: + $ref: "#/components/schemas/series" + service: + $ref: "#/components/schemas/service" + speech: + $ref: "#/components/schemas/speech" + total: + type: integer + version_group: + $ref: "#/components/schemas/version_group" + window: + $ref: "#/components/schemas/window" + required: + - page + - page_size + type: object + retryable: + type: boolean + revocation_status: + type: string + schedule_date: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + scheduled: + additionalProperties: false + properties: + end: + format: date-time + type: string + start: + format: date-time + type: string + type: object + scheduled_publication_rights: + additionalProperties: false + properties: + publication_rights: + items: + $ref: "#/components/schemas/publication_rights" + type: array + type: object + scheduled_time: + additionalProperties: false + properties: + end: + format: date-time + type: string + start: + format: date-time + type: string + type: object + season: + $ref: "#/components/schemas/group-body" + series: + additionalProperties: false + properties: + alternate_images_mixin: + $ref: "#/components/schemas/alternate_images_mixin" + ancestor_titles: + $ref: "#/components/schemas/ancestor_titles" + ancestors: + $ref: "#/components/schemas/ancestors" + ancestors_titles: + $ref: "#/components/schemas/ancestors_titles" + availability_mixin: + $ref: "#/components/schemas/availability_mixin" + contributions_mixin: + $ref: "#/components/schemas/contributions_mixin" + embargoed: + $ref: "#/components/schemas/embargoed" + expected_child_count: + $ref: "#/components/schemas/expected_child_count" + genre_groupings: + $ref: "#/components/schemas/genre_groupings" + identifiers: + $ref: "#/components/schemas/identifiers" + image_link: + $ref: "#/components/schemas/image_link" + images_mixin: + $ref: "#/components/schemas/images_mixin" + is_embeddable: + $ref: "#/components/schemas/is_embeddable" + items_for: + $ref: "#/components/schemas/items_for" + master_brand_link: + $ref: "#/components/schemas/master_brand_link" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + previous_next_mixin: + $ref: "#/components/schemas/previous_next_mixin" + programme_formats: + $ref: "#/components/schemas/programme_formats" + programme_type: + $ref: "#/components/schemas/programme_type" + related_links: + $ref: "#/components/schemas/related_links" + release_date_group: + $ref: "#/components/schemas/release_date_group" + series_of: + $ref: "#/components/schemas/series_of" + synopses: + $ref: "#/components/schemas/synopses" + title: + $ref: "#/components/schemas/title" + updated_time: + $ref: "#/components/schemas/updated_time" + uri: + $ref: "#/components/schemas/uri" + required: + - pid + - partner + - updated_time + - embargoed + type: object + series_of: + $ref: "#/components/schemas/pidReference" + service: + additionalProperties: false + properties: + date_range: + $ref: "#/components/schemas/date_range" + description: + $ref: "#/components/schemas/description" + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + is_concrete: + $ref: "#/components/schemas/is_concrete" + is_downloadable: + $ref: "#/components/schemas/is_downloadable" + is_streamable: + $ref: "#/components/schemas/is_streamable" + master_brand_link: + $ref: "#/components/schemas/master_brand_link" + media_type: + $ref: "#/components/schemas/media_type" + name: + $ref: "#/components/schemas/name" + partner: + $ref: "#/components/schemas/partner" + region: + $ref: "#/components/schemas/region" + sid: + $ref: "#/components/schemas/sid" + type: + $ref: "#/components/schemas/type" + updated_time: + $ref: "#/components/schemas/updated_time" + required: + - sid + - partner + type: object + serviceReference: + additionalProperties: false + properties: + href: + type: string + result_type: + type: string + sid: + type: string + required: + - result_type + - href + - sid + type: object + short: + type: string + sid: + pattern: "[a-z0-9A-Z_\\.\\-]+" + type: string + size: + additionalProperties: false + properties: + units: + type: string + type: object + snippet_url: + type: string + sort: + additionalProperties: false + properties: + deprecated: + type: boolean + deprecated_since: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + guaranteed_until: + pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}.*$ + type: string + is_default: + type: string + name: + type: string + release_status: + $ref: "#/components/schemas/release_status_type" + replaced_by: + type: string + sort_direction: + items: + $ref: "#/components/schemas/sort_direction" + type: array + title: + type: string + required: + - name + - title + type: object + sort_direction: + additionalProperties: false + properties: + href: + type: string + is_default: + type: string + name: + type: string + value: + type: string + required: + - name + - value + - is_default + - href + type: object + sorts: + additionalProperties: false + properties: + sort: + items: + $ref: "#/components/schemas/sort" + type: array + unstable_sorts: + $ref: "#/components/schemas/unstable_sorts" + type: object + source_asset: + additionalProperties: false + properties: + dimensions: + $ref: "#/components/schemas/dimensions" + focus_point: + $ref: "#/components/schemas/focus_point" + mime_type: + type: string + size: + $ref: "#/components/schemas/size" + uri: + type: string + type: object + source_media: + maxLength: 64 + minLength: 1 + type: string + speech: + $ref: "#/components/schemas/item" + start_time: + format: date-time + type: string + status: + type: string + synopses: + additionalProperties: false + properties: + long: + $ref: "#/components/schemas/long" + medium: + $ref: "#/components/schemas/medium" + short: + $ref: "#/components/schemas/short" + type: object + title: + type: string + track_number: + maxLength: 8 + minLength: 1 + type: string + track_side: + maxLength: 8 + minLength: 1 + type: string + tx_time: + additionalProperties: false + properties: + credits_showing: + format: date-time + type: string + end: + format: date-time + type: string + start: + format: date-time + type: string + type: object + type: + type: string + types_with_id: + additionalProperties: false + properties: + types: + additionalProperties: false + properties: + type: + items: + additionalProperties: false + properties: + id: + type: string + types: + additionalProperties: false + properties: + type: + items: + additionalProperties: false + properties: + id: + type: string + type: object + minItems: 1 + type: array + required: + - type + type: object + required: + - types + type: object + minItems: 1 + type: array + required: + - type + type: object + required: + - types + type: object + unstable_filters: + additionalProperties: false + properties: + filter: + items: + $ref: "#/components/schemas/filter" + type: array + type: object + unstable_mixins: + additionalProperties: false + properties: + mixin: + items: + $ref: "#/components/schemas/mixin" + type: array + type: object + unstable_sorts: + additionalProperties: false + properties: + sort: + items: + $ref: "#/components/schemas/sort" + type: array + type: object + updated_time: + format: date-time + type: string + uri: + type: string + url: + type: string + url_key: + type: string + version_availability: + additionalProperties: false + properties: + availability: + additionalProperties: false + properties: + availability: + additionalProperties: false + properties: + availability_end: + format: date-time + type: string + availability_start: + format: date-time + type: string + available_media_sets: + $ref: "#/components/schemas/available_media_sets" + status: + type: string + required: + - available_media_sets + type: object + availability_end: + format: date-time + type: string + availability_start: + format: date-time + type: string + available_media_sets: + $ref: "#/components/schemas/available_media_sets" + status: + type: string + required: + - available_media_sets + - availability + type: object + required: + - availability + type: object + version_availability_mixin: + additionalProperties: false + properties: + version: + items: + additionalProperties: false + properties: + availabilities: + items: + additionalProperties: false + properties: + version_availability: + items: + $ref: "#/components/schemas/version_availability" + minItems: 1 + type: array + required: + - version_availability + type: object + type: array + competition_warning: + type: string + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + guidance_warnings: + $ref: "#/components/schemas/guidance_warnings" + pid: + $ref: "#/components/schemas/pid" + types: + items: + additionalProperties: false + properties: + type: + items: + type: string + type: array + type: object + minItems: 1 + type: array + version: + items: + additionalProperties: false + properties: + availabilities: + items: + additionalProperties: false + properties: + version_availability: + items: + $ref: "#/components/schemas/version_availability" + minItems: 1 + type: array + required: + - version_availability + type: object + type: array + competition_warning: + type: string + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + guidance_warnings: + $ref: "#/components/schemas/guidance_warnings" + pid: + $ref: "#/components/schemas/pid" + types: + items: + additionalProperties: false + properties: + type: + items: + type: string + type: array + type: object + minItems: 1 + type: array + required: + - types + type: object + type: array + required: + - types + type: object + type: array + type: object + version_group: + additionalProperties: false + properties: + version: + additionalProperties: false + properties: + aspect_ratio: + type: string + competition_warning: + $ref: "#/components/schemas/competition_warning" + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + pid: + $ref: "#/components/schemas/pid" + types_with_id: + $ref: "#/components/schemas/types_with_id" + updated_time: + $ref: "#/components/schemas/updated_time" + version: + additionalProperties: false + properties: + aspect_ratio: + type: string + competition_warning: + $ref: "#/components/schemas/competition_warning" + duration: + pattern: ^(-)?P(?:([0-9,.]*)Y)?(?:([0-9,.]*)M)?(?:([0-9,.]*)W)?(?:([0-9,.]*)D)?(?:T(?:([0-9,.]*)H)?(?:([0-9,.]*)M)?(?:([0-9,.]*)S)?)?$ + type: string + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + pid: + $ref: "#/components/schemas/pid" + types_with_id: + $ref: "#/components/schemas/types_with_id" + updated_time: + $ref: "#/components/schemas/updated_time" + version_of: + $ref: "#/components/schemas/version_of" + version_types_with_id: + $ref: "#/components/schemas/version_types_with_id" + warnings: + $ref: "#/components/schemas/warnings" + required: + - pid + - updated_time + type: object + version_of: + $ref: "#/components/schemas/version_of" + version_types_with_id: + $ref: "#/components/schemas/version_types_with_id" + warnings: + $ref: "#/components/schemas/warnings" + required: + - pid + - updated_time + - version + type: object + required: + - version + type: object + version_of: + $ref: "#/components/schemas/pidReference" + version_types_with_id: + additionalProperties: false + properties: + version_types: + additionalProperties: false + properties: + version_type: + items: + additionalProperties: false + properties: + id: + type: string + version_types: + additionalProperties: false + properties: + version_type: + items: + additionalProperties: false + properties: + id: + type: string + type: object + minItems: 1 + type: array + required: + - version_type + type: object + required: + - version_types + type: object + minItems: 1 + type: array + required: + - version_type + type: object + required: + - version_types + type: object + versions: + additionalProperties: false + properties: + available: + type: integer + version_availability_mixin: + $ref: "#/components/schemas/version_availability_mixin" + required: + - version_availability_mixin + - available + type: object + versions_mixin: + additionalProperties: false + properties: + available_simulcasts: + $ref: "#/components/schemas/available_simulcasts" + available_versions: + $ref: "#/components/schemas/available_versions" + available_webcasts: + $ref: "#/components/schemas/available_webcasts" + versions: + items: + $ref: "#/components/schemas/versions" + type: array + type: object + warning: + additionalProperties: false + properties: + "#text": + type: string + short_description: + type: string + warning_code: + type: string + type: object + warning_items: + additionalProperties: false + properties: + warning: + items: + additionalProperties: false + properties: + "#text": + type: string + short_description: + type: string + warning: + items: + additionalProperties: false + properties: + "#text": + type: string + short_description: + type: string + warning_code: + type: string + type: object + type: array + warning_code: + type: string + type: object + type: array + type: object + warning_text: + additionalProperties: false + properties: + "#text": + type: string + length: + type: string + type: object + warning_texts: + additionalProperties: false + properties: + warning_text: + items: + additionalProperties: false + properties: + "#text": + type: string + length: + type: string + warning_text: + items: + additionalProperties: false + properties: + "#text": + type: string + length: + type: string + type: object + type: array + type: object + type: array + type: object + warnings: + additionalProperties: false + properties: + warning: + items: + $ref: "#/components/schemas/warning" + type: array + warning_text: + items: + $ref: "#/components/schemas/warning_text" + type: array + type: object + window: + additionalProperties: false + properties: + accurate_programme_time: + $ref: "#/components/schemas/accurate_programme_time" + ancestor_titles: + $ref: "#/components/schemas/ancestor_titles" + ancestors_titles: + $ref: "#/components/schemas/ancestors_titles" + identifiers: + $ref: "#/components/schemas/identifiers" + ids: + $ref: "#/components/schemas/ids" + image_link: + $ref: "#/components/schemas/image_link" + images_mixin: + $ref: "#/components/schemas/images_mixin" + media_availability_time: + $ref: "#/components/schemas/media_availability_time" + partner: + $ref: "#/components/schemas/partner" + pid: + $ref: "#/components/schemas/pid" + scheduled_publication_rights: + $ref: "#/components/schemas/scheduled_publication_rights" + scheduled_time: + $ref: "#/components/schemas/scheduled_time" + service: + $ref: "#/components/schemas/serviceReference" + updated_time: + $ref: "#/components/schemas/updated_time" + window_of: + items: + $ref: "#/components/schemas/window_of" + type: array + required: + - pid + - partner + type: object + window_of: + $ref: "#/components/schemas/pidReference" + xquery-version: + description: The XQuery language version. + enum: + - 1.0-ml + - 0.9-ml + - "1.0" + - XSLT + securitySchemes: + api_key: + in: query + name: api_key + type: apiKey diff --git a/fixtures/immutable/specifications/v3/bikewise.yaml b/fixtures/immutable/specifications/v3/bikewise.yaml new file mode 100644 index 00000000000..22f5e854213 --- /dev/null +++ b/fixtures/immutable/specifications/v3/bikewise.yaml @@ -0,0 +1,335 @@ +openapi: 3.0.0 +servers: + - url: https://bikewise.org/api +info: + contact: + email: support@bikeindex.org + description: > +This is an API for accessing information about bicycling related + incidents. You can find the source code on GitHub.
+ title: BikeWise API v2 + version: v2 + x-apisguru-categories: + - open_data + x-logo: + url: https://www.bikewise.org/fav.ico + x-origin: + - converter: + url: https://github.com/lucybot/api-spec-converter + version: 2.7.31 + format: swagger + url: https://bikewise.org/api/v2/swagger_doc + version: "1.2" + x-providerName: bikewise.org +externalDocs: + url: https://www.bikewise.org/documentation/api_v2 +tags: + - description: Incidents matching parameters + name: incidents + - description: GeoJSON response for matching incidents + name: locations +paths: + /v2/incidents: + get: + description: > + +If you’d like more detailed information about bike incidents, use this endpoint. For mapping, locations is probably a better bet.
Notes on location searching:
+
+ - proximity accepts an ip address, an address, zipcode, city, or latitude,longitude - i.e. 70.210.133.87, 210 NW 11th Ave, Portland, OR, 60647, Chicago, IL, and 45.521728,-122.67326 are all acceptable
+
+ - proximity_square sets the length of the sides of the square to find matches inside of. The square is centered on the location specified by proximity. It defaults to 100.
Page of results to fetch.
+ in: query + name: page + required: false + schema: + default: 1 + format: int32 + type: integer + - description: | +Number of results to return per page.
+ in: query + name: per_page + required: false + schema: + format: int32 + type: integer + - description: | +End of period
+ in: query + name: occurred_before + required: false + schema: + format: int32 + type: integer + - description: | +Start of period
+ in: query + name: occurred_after + required: false + schema: + format: int32 + type: integer + - description: | +Only incidents of specific type
+ in: query + name: incident_type + required: false + schema: + enum: + - crash + - hazard + - theft + - unconfirmed + - infrastructure_issue + - chop_shop + type: string + - description: | +Center of location for proximity search
+ in: query + name: proximity + required: false + schema: + type: string + - description: | +Size of the proximity search
+ in: query + name: proximity_square + required: false + schema: + default: 100 + format: int32 + type: integer + - description: | +Full text search of incidents
+ in: query + name: query + required: false + schema: + type: string + responses: + "200": + description: No response was specified + summary: Paginated incidents matching parameters + tags: + - incidents + "/v2/incidents/{id}": + get: + operationId: GET--version-incidents--id---format- + parameters: + - description: | +Incident ID
+ in: path + name: id + required: true + schema: + format: int32 + type: integer + responses: + "200": + description: No response was specified + tags: + - incidents + /v2/locations: + get: + description: > +This endpoint behaves exactly like
+ incidents, but returns a valid geojson
+ FeatureCollection that looks like this:
{
+ type: "FeatureCollection",
+ features: [
+ {
+ type: "Feature",
+ properties: {
+ id: 4474199,
+ type: "Theft",
+ occurred_at: 1428536937
+ },
+ geometry: {
+ type: "Point",
+ coordinates: [ -122.6244177, 45.5164386 ]
+ }
+ }
+ }
+
+
+
+
+ It doesn’t paginate. If you pass the all parameter it returns all matches (which can be big, > 4mb), otherwise it returns the 100 most recent.
Go forth and make maps!
+ operationId: GET--version-locations---format- + parameters: + - description: | +End of period
+ in: query + name: occurred_before + required: false + schema: + format: int32 + type: integer + - description: | +Start of period
+ in: query + name: occurred_after + required: false + schema: + format: int32 + type: integer + - description: | +Only incidents of specific type
+ in: query + name: incident_type + required: false + schema: + enum: + - crash + - hazard + - theft + - unconfirmed + - infrastructure_issue + - chop_shop + type: string + - description: | +Center of location for proximity search
+ in: query + name: proximity + required: false + schema: + type: string + - description: | +Size of the proximity search
+ in: query + name: proximity_square + required: false + schema: + default: 100 + format: int32 + type: integer + - description: | +Full text search of incidents
+ in: query + name: query + required: false + schema: + type: string + - description: | +Max number of results to return. Defaults to 100
+ in: query + name: limit + required: false + schema: + format: int32 + type: integer + - description: | +Give ‘em all to me. Will ignore limit
+ in: query + name: all + required: false + schema: + type: boolean + responses: + "200": + description: No response was specified + summary: Unpaginated geojson response + tags: + - locations + /v2/locations/markers: + get: + description: > +This behaves exactly like the root locations
+ endpoint, but returns simplestyled
+ markers (mapbox styled
+ markers)
Go forth and make maps!
+ operationId: GET--version-locations-markers---format- + parameters: + - description: | +End of period
+ in: query + name: occurred_before + required: false + schema: + format: int32 + type: integer + - description: | +Start of period
+ in: query + name: occurred_after + required: false + schema: + format: int32 + type: integer + - description: | +Only incidents of specific type
+ in: query + name: incident_type + required: false + schema: + enum: + - crash + - hazard + - theft + - unconfirmed + - infrastructure_issue + - chop_shop + type: string + - description: | +Center of location for proximity search
+ in: query + name: proximity + required: false + schema: + type: string + - description: | +Size of the proximity search
+ in: query + name: proximity_square + required: false + schema: + default: 100 + format: int32 + type: integer + - description: | +Full text search of incidents
+ in: query + name: query + required: false + schema: + type: string + - description: | +Max number of results to return. Defaults to 100
+ in: query + name: limit + required: false + schema: + format: int32 + type: integer + - description: | +Give ‘em all to me. Will ignore limit
+ in: query + name: all + required: false + schema: + type: boolean + responses: + "200": + description: No response was specified + summary: Unpaginated geojson response with simplestyled markers + tags: + - locations diff --git a/fixtures/immutable/specifications/v3/circleci.yaml b/fixtures/immutable/specifications/v3/circleci.yaml new file mode 100644 index 00000000000..1b456df1195 --- /dev/null +++ b/fixtures/immutable/specifications/v3/circleci.yaml @@ -0,0 +1,993 @@ +openapi: 3.0.0 +servers: + - url: https://circleci.com/api/v1 +info: + description: > + The CircleCI API is a RESTful, fully-featured API that allows you + to do almost anything in CircleCI. + + You can access all information and trigger all actions. + + The only thing we don’t provide access to is billing functions, which must be done from the CircleCI web UI. + license: + name: Attribution-NonCommercial-ShareAlike 4.0 International + url: http://creativecommons.org/licenses/by-nc-sa/4.0/ + title: CircleCI REST API + version: v1 + x-apisguru-categories: + - developer_tools + x-logo: + url: https://avatars0.githubusercontent.com/u/1231870?v=3&s=200 + x-origin: + - format: openapi + url: https://raw.githubusercontent.com/kamikazechaser/spec-circleci/master/swagger.yml + version: "3.0" + x-providerName: circleci.com + x-unofficialSpec: true +security: + - apikey: [] +paths: + /me: + get: + description: | + Provides information about the signed in user. + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/User" + description: signed in user + "/project/{username}/{project}": + get: + description: | + Build summary for each of the last 30 builds for a single git repo. + parameters: + - $ref: "#/components/parameters/limit" + - $ref: "#/components/parameters/offset" + - $ref: "#/components/parameters/filter" + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Builds" + description: Build summary for each of the last 30 builds + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + post: + description: | + Triggers a new build, returns a summary of the build. + requestBody: + content: + application/json: + schema: + properties: + build_parameters: + $ref: "#/components/schemas/BuildParameters" + parallel: + $ref: "#/components/schemas/Parallel" + revision: + $ref: "#/components/schemas/Revision" + tag: + $ref: "#/components/schemas/Tag" + type: object + responses: + "201": + content: + application/json: + schema: + $ref: "#/components/schemas/BuildSummary" + description: returns a summary of the build + "/project/{username}/{project}/build-cache": + delete: + description: | + Clears the cache for a project. + responses: + "200": + content: + application/json: + schema: + properties: + status: + type: string + type: object + description: status message + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + "/project/{username}/{project}/checkout-key": + get: + description: | + Lists checkout keys. + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Keys" + description: checkout keys + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + post: + description: | + Creates a new checkout key. + Only usable with a user API token. + requestBody: + content: + application/json: + schema: + enum: + - deploy-key + - github-user-key + type: string + description: | + The type of key to create. Can be 'deploy-key' or 'github-user-key'. + responses: + "200": + $ref: "#/components/responses/key" + "/project/{username}/{project}/checkout-key/{fingerprint}": + delete: + description: | + Delete a checkout key. + responses: + "200": + content: + application/json: + schema: + properties: + message: + enum: + - OK + type: string + type: object + description: status message + get: + description: | + Get a checkout key. + responses: + "200": + $ref: "#/components/responses/key" + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/fingerprint" + "/project/{username}/{project}/envvar": + get: + description: | + Lists the environment variables for :project + responses: + "200": + $ref: "#/components/responses/envvars" + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + post: + description: | + Creates a new environment variable + responses: + "200": + $ref: "#/components/responses/envvar" + "/project/{username}/{project}/envvar/{name}": + delete: + description: | + Deletes the environment variable named ':name' + responses: + "200": + content: + application/json: + schema: + properties: + message: + enum: + - OK + type: string + type: object + description: | + Deletes the environment variable named ':name' + get: + description: | + Gets the hidden value of environment variable :name + responses: + "200": + $ref: "#/components/responses/envvar" + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/envvar_name" + "/project/{username}/{project}/ssh-key": + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + post: + description: > + Create an ssh key used to access external systems that require SSH + key-based authentication + parameters: + - in: header + name: Content-Type + required: true + schema: + enum: + - application/json + type: string + requestBody: + content: + application/json: + schema: + properties: + hostname: + type: string + private_key: + type: string + type: object + required: true + responses: + default: + content: + application/json: + examples: + response: + value: + message: a private key is required + schema: + properties: + message: + type: string + type: object + description: no response expected + "/project/{username}/{project}/tree/{branch}": + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/branch" + post: + description: > + Triggers a new build, returns a summary of the build. + + Optional build parameters can be set using an experimental API. + + + Note: For more about build parameters, read about [using parameterized builds](https://circleci.com/docs/parameterized-builds/) + requestBody: + content: + application/json: + schema: + properties: + build_parameters: + $ref: "#/components/schemas/BuildParameters" + parallel: + $ref: "#/components/schemas/Parallel" + revision: + $ref: "#/components/schemas/Revision" + type: object + responses: + "201": + content: + application/json: + schema: + $ref: "#/components/schemas/Build" + description: returns a summary of the build + headers: + Location: + schema: + format: uri + type: string + "/project/{username}/{project}/{build_num}": + get: + description: > + Full details for a single build. The response includes all of the + fields from the build summary. + + This is also the payload for the [notification webhooks](/docs/configuration/#notify), in which case this object is the value to a key named 'payload'. + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/BuildDetail" + description: Full details for a single build + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/build_num" + "/project/{username}/{project}/{build_num}/artifacts": + get: + description: | + List the artifacts produced by a given build. + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Artifacts" + description: List the artifacts produced by a given build + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/build_num" + "/project/{username}/{project}/{build_num}/cancel": + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/build_num" + post: + description: | + Cancels the build, returns a summary of the build. + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Build" + description: returns a summary of the build + "/project/{username}/{project}/{build_num}/retry": + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/build_num" + post: + description: | + Retries the build, returns a summary of the new build. + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Build" + description: returns a summary of the new build + "/project/{username}/{project}/{build_num}/tests": + get: + description: > + Provides test metadata for a build + + Note: [Learn how to set up your builds to collect test metadata](https://circleci.com/docs/test-metadata/) + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Tests" + description: | + test metadata for a build + parameters: + - $ref: "#/components/parameters/username" + - $ref: "#/components/parameters/project" + - $ref: "#/components/parameters/build_num" + /projects: + get: + description: > + List of all the projects you're following on CircleCI, with build + information organized by branch. + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Projects" + description: | + List of all the projects you're following on CircleCI + /recent-builds: + get: + description: > + Build summary for each of the last 30 recent builds, ordered by + build_num. + parameters: + - $ref: "#/components/parameters/limit" + - $ref: "#/components/parameters/offset" + responses: + "200": + content: + application/json: + schema: + $ref: "#/components/schemas/Builds" + description: Build summary for each of the last 30 recent builds + /user/heroku-key: + post: + description: | + Adds your Heroku API key to CircleCI, takes apikey as form param name. + responses: + "403": + content: + application/json: + schema: + properties: + message: + type: string + type: object + description: | + Your Heroku API key is invalid. +components: + parameters: + branch: + description: | + The branch name should be url-encoded. + in: path + name: branch + required: true + schema: + type: string + build_num: + description: | + XXXXXXXXXX + in: path + name: build_num + required: true + schema: + type: integer + envvar_name: + description: | + XXXXXXXXXX + in: path + name: name + required: true + schema: + type: string + filter: + description: > + Restricts which builds are returned. + + Set to "completed", "successful", "failed", "running", or defaults to no filter. + in: query + name: filter + schema: + enum: + - completed + - successful + - failed + - running + type: string + fingerprint: + description: | + XXXXXXXXXX + in: path + name: fingerprint + required: true + schema: + type: string + limit: + description: | + The number of builds to return. Maximum 100, defaults to 30. + in: query + name: limit + schema: + default: 30 + maximum: 100 + type: integer + offset: + description: | + The API returns builds starting from this offset, defaults to 0. + in: query + name: offset + schema: + default: 0 + type: integer + project: + description: | + XXXXXXXXX + in: path + name: project + required: true + schema: + type: string + username: + description: | + XXXXXXXXX + in: path + name: username + required: true + schema: + type: string + responses: + envvar: + content: + application/json: + schema: + $ref: "#/components/schemas/Envvar" + description: XXX + envvars: + content: + application/json: + schema: + $ref: "#/components/schemas/Envvars" + description: XXX + key: + content: + application/json: + schema: + $ref: "#/components/schemas/Key" + description: checkout key + schemas: + Artifact: + properties: + node_index: + type: integer + path: + type: string + pretty_path: + type: string + url: + type: string + type: object + Artifacts: + items: + $ref: "#/components/schemas/Artifact" + type: array + Aws: + properties: + keypair: + nullable: true + type: string + type: object + Build: + properties: + body: + description: commit message body + type: string + branch: + type: string + build_time_millis: + type: integer + build_url: + format: uri + type: string + committer_email: + format: email + type: string + committer_name: + type: string + dont_build: + description: reason why we didn't build, if we didn't build + nullable: true + type: string + lifecycle: + $ref: "#/components/schemas/Lifecycle" + previous: + $ref: "#/components/schemas/PreviousBuild" + queued_at: + description: time build was queued + format: date-time + type: string + reponame: + type: string + retry_of: + description: build_num of the build this is a retry of + nullable: true + type: integer + start_time: + description: time build started + format: date-time + type: string + stop_time: + description: time build finished + format: date-time + type: string + subject: + type: string + username: + type: string + vcs_url: + format: uri + type: string + why: + description: short string explaining the reason we built + type: string + type: object + BuildDetail: + description: previous build + properties: + all_commit_details: + $ref: "#/components/schemas/CommitDetails" + compare: + format: uri + nullable: true + type: string + job_name: + type: string + node: + nullable: true + previous_successful_build: + $ref: "#/components/schemas/PreviousBuild" + retries: + nullable: true + type: boolean + ssh_enabled: + nullable: true + type: boolean + timedout: + nullable: true + type: boolean + usage_queued_at: + format: date-time + type: string + user: + $ref: "#/components/schemas/User" + type: object + BuildParameters: + description: > + Additional environment variables to inject into the build + environment. A map of names to values. + type: object + BuildSummary: + properties: + added_at: + format: date-time + type: string + build_num: + type: integer + outcome: + $ref: "#/components/schemas/Outcome" + pushed_at: + format: date-time + type: string + status: + $ref: "#/components/schemas/Status" + vcs_revision: + $ref: "#/components/schemas/Sha1" + type: object + Builds: + items: + $ref: "#/components/schemas/Build" + type: array + CommitDetail: + properties: + author_date: + format: date-time + type: string + author_email: + format: email + type: string + author_login: + type: string + author_name: + type: string + body: + type: string + commit: + $ref: "#/components/schemas/Sha1" + commit_url: + format: uri + type: string + committer_date: + format: date-time + type: string + committer_email: + format: email + type: string + committer_login: + type: string + committer_name: + type: string + subject: + type: string + type: object + CommitDetails: + items: + $ref: "#/components/schemas/CommitDetail" + type: array + Envvar: + properties: + name: + type: string + value: + type: string + type: object + Envvars: + items: + $ref: "#/components/schemas/Envvar" + type: array + Key: + properties: + fingerprint: + type: string + preferred: + type: boolean + public_key: + type: string + time: + description: when the key was issued + format: date-time + type: string + type: + description: | + can be "deploy-key" or "github-user-key" + enum: + - deploy-key + - github-user-key + type: string + type: object + Keys: + items: + $ref: "#/components/schemas/Key" + type: array + Lifecycle: + enum: + - queued + - scheduled + - not_run + - not_running + - running + - finished + type: string + Outcome: + enum: + - canceled + - infrastructure_fail + - timedout + - failed + - no_tests + - success + type: string + Parallel: + description: > + The number of containers to use to run the build. Default is null + and the project default is used. + type: string + PreviousBuild: + description: previous build + properties: + build_num: + type: integer + build_time_millis: + type: integer + status: + $ref: "#/components/schemas/Status" + type: object + Project: + properties: + aws: + $ref: "#/components/schemas/Aws" + branches: + type: object + campfire_notify_prefs: + $ref: "#/components/schemas/StringOrNull" + campfire_room: + $ref: "#/components/schemas/StringOrNull" + campfire_subdomain: + $ref: "#/components/schemas/StringOrNull" + campfire_token: + $ref: "#/components/schemas/StringOrNull" + compile: + type: string + default_branch: + type: string + dependencies: + type: string + extra: + type: string + feature_flags: + properties: + build-fork-prs: + type: boolean + fleet: + nullable: true + type: boolean + junit: + type: boolean + oss: + type: boolean + osx: + type: boolean + set-github-status: + type: boolean + trusty-beta: + type: boolean + type: object + flowdock_api_token: + $ref: "#/components/schemas/StringOrNull" + followed: + type: boolean + has_usable_key: + type: boolean + heroku_deploy_user: + $ref: "#/components/schemas/StringOrNull" + hipchat_api_token: + $ref: "#/components/schemas/StringOrNull" + hipchat_notify: + $ref: "#/components/schemas/StringOrNull" + hipchat_notify_prefs: + nullable: true + type: string + hipchat_room: + $ref: "#/components/schemas/StringOrNull" + irc_channel: + $ref: "#/components/schemas/StringOrNull" + irc_keyword: + $ref: "#/components/schemas/StringOrNull" + irc_notify_prefs: + $ref: "#/components/schemas/StringOrNull" + irc_password: + $ref: "#/components/schemas/StringOrNull" + irc_server: + $ref: "#/components/schemas/StringOrNull" + irc_username: + $ref: "#/components/schemas/StringOrNull" + language: + type: string + oss: + type: boolean + parallel: + type: integer + reponame: + type: string + scopes: + items: + $ref: "#/components/schemas/Scope" + type: array + setup: + type: string + slack_api_token: + $ref: "#/components/schemas/StringOrNull" + slack_channel: + $ref: "#/components/schemas/StringOrNull" + slack_channel_override: + $ref: "#/components/schemas/StringOrNull" + slack_notify_prefs: + $ref: "#/components/schemas/StringOrNull" + slack_subdomain: + $ref: "#/components/schemas/StringOrNull" + slack_webhook_url: + format: uri + type: string + ssh_keys: + items: + type: string + type: array + test: + type: string + username: + type: string + vcs_type: + type: string + vcs_url: + format: uri + type: string + type: object + Projects: + items: + $ref: "#/components/schemas/Project" + type: array + Revision: + description: > + The specific revision to build. + + Default is null and the head of the branch is used. Cannot be used with tag parameter. + type: string + Scope: + enum: + - write-settings + - view-builds + - read-settings + - trigger-builds + - all + - status + - none + type: string + Sha1: + type: string + Status: + enum: + - retried + - canceled + - infrastructure_fail + - timedout + - not_run + - running + - failed + - queued + - scheduled + - not_running + - no_tests + - fixed + - success + type: string + StringOrNull: + nullable: true + type: string + Tag: + description: > + The tag to build. Default is null. Cannot be used with revision + parameter. + type: string + Tests: + properties: + tests: + items: + properties: + classname: + type: string + file: + type: string + message: + type: string + name: + type: string + result: + $ref: "#/components/schemas/Status" + run_time: + type: number + source: + type: string + type: object + type: array + type: object + User: + properties: + admin: + type: boolean + all_emails: + items: + format: email + type: string + type: array + analytics_id: + type: string + avatar_url: + format: uri + type: string + basic_email_prefs: + type: string + bitbucket: + nullable: true + type: integer + bitbucket_authorized: + type: boolean + containers: + type: integer + created_at: + format: date-time + type: string + days_left_in_trial: + type: integer + dev_admin: + type: boolean + enrolled_betas: + items: + type: string + type: array + github_id: + nullable: true + type: integer + github_oauth_scopes: + items: + type: string + type: array + gravatar_id: + nullable: true + type: integer + heroku_api_key: + nullable: true + type: string + in_beta_program: + type: boolean + login: + type: string + name: + type: string + organization_prefs: + type: object + parallelism: + type: integer + plan: + nullable: true + type: string + projects: + type: object + pusher_id: + type: string + selected_email: + format: email + type: string + sign_in_count: + type: integer + trial_end: + format: date-time + type: string + type: object + securitySchemes: + apikey: + in: query + name: circle-token + type: apiKey diff --git a/fixtures/immutable/specifications/v3/circuitSandbox.yaml b/fixtures/immutable/specifications/v3/circuitSandbox.yaml new file mode 100644 index 00000000000..b322aab3f80 --- /dev/null +++ b/fixtures/immutable/specifications/v3/circuitSandbox.yaml @@ -0,0 +1,7925 @@ +openapi: 3.0.0 +servers: + - url: https://circuitsandbox.net/rest/v2 +x-hasEquivalentPaths: true +info: + description: >- + Circuit REST API to interact with the Circuit system. + + + [Learn more about the Circuit Development Community](https://www.circuit.com/web/developers/home) + title: REST API Version 2 + version: 2.9.232 + x-apisguru-categories: + - messaging + x-logo: + backgroundColor: "#FFFFFF" + url: https://pbs.twimg.com/profile_images/927933988269903874/4jU82-IJ_400x400.jpg + x-origin: + - format: openapi + url: https://circuitsandbox.net/rest/v2/swagger + version: "3.0" + x-providerName: circuitsandbox.net +securityDefinitions: + oauth: + scopes: + C4O365: {} +paths: + /conversations: + get: + description: >- + Gets a list of conversations and communities the authenticated user + participates in. + + OauthScopes: READ_CONVERSATIONS + operationId: getConversations + parameters: + - description: The modification time of the conversation in UTC format. During the + query the conversations before (default) or after this + timestamp are returned. In case no timestamp is specified the + current server time in UTC is used, i.e. the last 25 modified + conversations are returned + in: query + name: modTime + required: false + schema: + format: date-time + type: string + - description: The direction of the search based on the modification time. Valid + values are either BEFORE (default) or AFTER + in: query + name: direction + required: false + schema: + default: BEFORE + enum: + - BEFORE + - AFTER + maxLength: 2048 + type: string + - description: The maximum number of returned results (default 25). The maximum + allowed value is 100. + in: query + name: results + required: false + schema: + default: 25 + format: int32 + maximum: 100 + minimum: 1 + type: number + responses: + "200": + content: + application/json: + schema: + items: + $ref: "#/components/schemas/Conversation" + type: array + application/xml: + schema: + items: + $ref: "#/components/schemas/Conversation" + type: array + description: The matching conversations + "400": + description: "The request cannot be fulfilled due to bad syntax:
+
+
+ * If there are no results, a response code of `304` will be returned.
+
+
+ * If the response is the last set of results, a response code of `200` or
+
+ `206` will be returned.
+
+
+ * If there are more results, a response code of `206` will be returned.
+
+
+ * If `X-Next-Token` is provided in the request headers but the token has
+
+ expired, a response code of `409` will be returned. This is only applicable
+
+ for some endpoints; see specific endpoint documentation below.
+
+
+ #### X-Limit
+
+
+ The page size can be controlled with the `X-Limit` header. Valid values are
+
+ `1-100` and defaults to `100`.
+
+
+ #### X-Next-Token
+
+
+ If the results are paginated, a response header of `X-Next-Token` will be
+
+ returned. Use the associated value in the subsequent request (via the `X-Next-Token`
+
+ request header) to retrieve the next page. The following sequence diagram shows how to
+
+ use `X-Next-Token` to fetch all the records.
+
+
+