aws_api_gateway_documentation_part

Provides a settings of an API Gateway Documentation Part.

Example Usage

resource "aws_api_gateway_documentation_part" "example" {
  location {
    type = "METHOD"
    method = "GET"
    path = "/example"
  }
  properties = "{\"description\":\"Example description\"}"
  rest_api_id = "${aws_api_gateway_rest_api.example.id}"
}

resource "aws_api_gateway_rest_api" "example" {
  name = "example_api"
}

Argument Reference

The following argument is supported:

  • location - (Required) The location of the targeted API entity of the to-be-created documentation part. See below.
  • properties - (Required) A content map of API-specific key-value pairs describing the targeted API entity. The map must be encoded as a JSON string, e.g., "{ \"description\": \"The API does ...\" }". Only Swagger-compliant key-value pairs can be exported and, hence, published.
  • rest_api_id - (Required) The ID of the associated Rest API

Nested fields

location

See supported entity types for each field in the official docs.

  • method - (Optional) The HTTP verb of a method. The default value is * for any method.
  • name - (Optional) The name of the targeted API entity.
  • path - (Optional) The URL path of the target. The default value is / for the root resource.
  • status_code - (Optional) The HTTP status code of a response. The default value is * for any status code.
  • type - (Required) The type of API entity to which the documentation content applies. e.g. API, METHOD or REQUEST_BODY

Attribute Reference

The following attribute is exported in addition to the arguments listed above:

  • id - The unique ID of the Documentation Part

Import

API Gateway documentation_parts can be imported using REST-API-ID/DOC-PART-ID, e.g.

$ terraform import aws_api_gateway_documentation_part.example 5i4e1ko720/3oyy3t

© 2018 HashiCorp
Licensed under the MPL 2.0 License.
https://www.terraform.io/docs/providers/aws/r/api_gateway_documentation_part.html