1. Packages
  2. AWS Native
  3. API Docs
  4. apigateway
  5. DocumentationPart

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi

aws-native.apigateway.DocumentationPart

Explore with Pulumi AI

aws-native logo

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi

    The AWS::ApiGateway::DocumentationPart resource creates a documentation part for an API. For more information, see Representation of API Documentation in API Gateway in the API Gateway Developer Guide.

    Create DocumentationPart Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new DocumentationPart(name: string, args: DocumentationPartArgs, opts?: CustomResourceOptions);
    @overload
    def DocumentationPart(resource_name: str,
                          args: DocumentationPartArgs,
                          opts: Optional[ResourceOptions] = None)
    
    @overload
    def DocumentationPart(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          location: Optional[DocumentationPartLocationArgs] = None,
                          properties: Optional[str] = None,
                          rest_api_id: Optional[str] = None)
    func NewDocumentationPart(ctx *Context, name string, args DocumentationPartArgs, opts ...ResourceOption) (*DocumentationPart, error)
    public DocumentationPart(string name, DocumentationPartArgs args, CustomResourceOptions? opts = null)
    public DocumentationPart(String name, DocumentationPartArgs args)
    public DocumentationPart(String name, DocumentationPartArgs args, CustomResourceOptions options)
    
    type: aws-native:apigateway:DocumentationPart
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args DocumentationPartArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DocumentationPartArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DocumentationPartArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DocumentationPartArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DocumentationPartArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    const documentationPartResource = new aws_native.apigateway.DocumentationPart("documentationPartResource", {
        location: {
            method: "string",
            name: "string",
            path: "string",
            statusCode: "string",
            type: aws_native.apigateway.DocumentationPartLocationType.Api,
        },
        properties: "string",
        restApiId: "string",
    });
    
    Coming soon!
    

    DocumentationPart Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The DocumentationPart resource accepts the following input properties:

    Location Pulumi.AwsNative.ApiGateway.Inputs.DocumentationPartLocation
    The location of the targeted API entity of the to-be-created documentation part.
    Properties string
    The new documentation content map of the targeted API entity. Enclosed key-value pairs are API-specific, but only OpenAPI-compliant key-value pairs can be exported and, hence, published.
    RestApiId string
    The string identifier of the associated RestApi.
    Location DocumentationPartLocationArgs
    The location of the targeted API entity of the to-be-created documentation part.
    Properties string
    The new documentation content map of the targeted API entity. Enclosed key-value pairs are API-specific, but only OpenAPI-compliant key-value pairs can be exported and, hence, published.
    RestApiId string
    The string identifier of the associated RestApi.
    location DocumentationPartLocation
    The location of the targeted API entity of the to-be-created documentation part.
    properties String
    The new documentation content map of the targeted API entity. Enclosed key-value pairs are API-specific, but only OpenAPI-compliant key-value pairs can be exported and, hence, published.
    restApiId String
    The string identifier of the associated RestApi.
    location DocumentationPartLocation
    The location of the targeted API entity of the to-be-created documentation part.
    properties string
    The new documentation content map of the targeted API entity. Enclosed key-value pairs are API-specific, but only OpenAPI-compliant key-value pairs can be exported and, hence, published.
    restApiId string
    The string identifier of the associated RestApi.
    location DocumentationPartLocationArgs
    The location of the targeted API entity of the to-be-created documentation part.
    properties str
    The new documentation content map of the targeted API entity. Enclosed key-value pairs are API-specific, but only OpenAPI-compliant key-value pairs can be exported and, hence, published.
    rest_api_id str
    The string identifier of the associated RestApi.
    location Property Map
    The location of the targeted API entity of the to-be-created documentation part.
    properties String
    The new documentation content map of the targeted API entity. Enclosed key-value pairs are API-specific, but only OpenAPI-compliant key-value pairs can be exported and, hence, published.
    restApiId String
    The string identifier of the associated RestApi.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DocumentationPart resource produces the following output properties:

    DocumentationPartId string
    Id string
    The provider-assigned unique ID for this managed resource.
    DocumentationPartId string
    Id string
    The provider-assigned unique ID for this managed resource.
    documentationPartId String
    id String
    The provider-assigned unique ID for this managed resource.
    documentationPartId string
    id string
    The provider-assigned unique ID for this managed resource.
    documentation_part_id str
    id str
    The provider-assigned unique ID for this managed resource.
    documentationPartId String
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    DocumentationPartLocation, DocumentationPartLocationArgs

    Method string
    The HTTP verb of a method. It is a valid field for the API entity types of METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's method attribute must match that of the parent entity exactly.
    Name string
    The name of the targeted API entity. It is a valid and required field for the API entity types of AUTHORIZER, MODEL, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY and RESPONSE_HEADER. It is an invalid field for any other entity type.
    Path string
    The URL path of the target. It is a valid field for the API entity types of RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is / for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other location attributes, the child entity's path attribute must match that of the parent entity as a prefix.
    StatusCode string
    The HTTP status code of a response. It is a valid field for the API entity types of RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's statusCode attribute must match that of the parent entity exactly.
    Type Pulumi.AwsNative.ApiGateway.DocumentationPartLocationType
    The type of API entity to which the documentation content applies. Valid values are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Content inheritance does not apply to any entity of the API, AUTHORIZER, METHOD, MODEL, REQUEST_BODY, or RESOURCE type.
    Method string
    The HTTP verb of a method. It is a valid field for the API entity types of METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's method attribute must match that of the parent entity exactly.
    Name string
    The name of the targeted API entity. It is a valid and required field for the API entity types of AUTHORIZER, MODEL, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY and RESPONSE_HEADER. It is an invalid field for any other entity type.
    Path string
    The URL path of the target. It is a valid field for the API entity types of RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is / for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other location attributes, the child entity's path attribute must match that of the parent entity as a prefix.
    StatusCode string
    The HTTP status code of a response. It is a valid field for the API entity types of RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's statusCode attribute must match that of the parent entity exactly.
    Type DocumentationPartLocationType
    The type of API entity to which the documentation content applies. Valid values are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Content inheritance does not apply to any entity of the API, AUTHORIZER, METHOD, MODEL, REQUEST_BODY, or RESOURCE type.
    method String
    The HTTP verb of a method. It is a valid field for the API entity types of METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's method attribute must match that of the parent entity exactly.
    name String
    The name of the targeted API entity. It is a valid and required field for the API entity types of AUTHORIZER, MODEL, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY and RESPONSE_HEADER. It is an invalid field for any other entity type.
    path String
    The URL path of the target. It is a valid field for the API entity types of RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is / for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other location attributes, the child entity's path attribute must match that of the parent entity as a prefix.
    statusCode String
    The HTTP status code of a response. It is a valid field for the API entity types of RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's statusCode attribute must match that of the parent entity exactly.
    type DocumentationPartLocationType
    The type of API entity to which the documentation content applies. Valid values are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Content inheritance does not apply to any entity of the API, AUTHORIZER, METHOD, MODEL, REQUEST_BODY, or RESOURCE type.
    method string
    The HTTP verb of a method. It is a valid field for the API entity types of METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's method attribute must match that of the parent entity exactly.
    name string
    The name of the targeted API entity. It is a valid and required field for the API entity types of AUTHORIZER, MODEL, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY and RESPONSE_HEADER. It is an invalid field for any other entity type.
    path string
    The URL path of the target. It is a valid field for the API entity types of RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is / for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other location attributes, the child entity's path attribute must match that of the parent entity as a prefix.
    statusCode string
    The HTTP status code of a response. It is a valid field for the API entity types of RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's statusCode attribute must match that of the parent entity exactly.
    type DocumentationPartLocationType
    The type of API entity to which the documentation content applies. Valid values are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Content inheritance does not apply to any entity of the API, AUTHORIZER, METHOD, MODEL, REQUEST_BODY, or RESOURCE type.
    method str
    The HTTP verb of a method. It is a valid field for the API entity types of METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's method attribute must match that of the parent entity exactly.
    name str
    The name of the targeted API entity. It is a valid and required field for the API entity types of AUTHORIZER, MODEL, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY and RESPONSE_HEADER. It is an invalid field for any other entity type.
    path str
    The URL path of the target. It is a valid field for the API entity types of RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is / for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other location attributes, the child entity's path attribute must match that of the parent entity as a prefix.
    status_code str
    The HTTP status code of a response. It is a valid field for the API entity types of RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's statusCode attribute must match that of the parent entity exactly.
    type DocumentationPartLocationType
    The type of API entity to which the documentation content applies. Valid values are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Content inheritance does not apply to any entity of the API, AUTHORIZER, METHOD, MODEL, REQUEST_BODY, or RESOURCE type.
    method String
    The HTTP verb of a method. It is a valid field for the API entity types of METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's method attribute must match that of the parent entity exactly.
    name String
    The name of the targeted API entity. It is a valid and required field for the API entity types of AUTHORIZER, MODEL, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY and RESPONSE_HEADER. It is an invalid field for any other entity type.
    path String
    The URL path of the target. It is a valid field for the API entity types of RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is / for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other location attributes, the child entity's path attribute must match that of the parent entity as a prefix.
    statusCode String
    The HTTP status code of a response. It is a valid field for the API entity types of RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's statusCode attribute must match that of the parent entity exactly.
    type "API" | "AUTHORIZER" | "MODEL" | "RESOURCE" | "METHOD" | "PATH_PARAMETER" | "QUERY_PARAMETER" | "REQUEST_HEADER" | "REQUEST_BODY" | "RESPONSE" | "RESPONSE_HEADER" | "RESPONSE_BODY"
    The type of API entity to which the documentation content applies. Valid values are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Content inheritance does not apply to any entity of the API, AUTHORIZER, METHOD, MODEL, REQUEST_BODY, or RESOURCE type.

    DocumentationPartLocationType, DocumentationPartLocationTypeArgs

    Api
    API
    Authorizer
    AUTHORIZER
    Model
    MODEL
    Resource
    RESOURCE
    Method
    METHOD
    PathParameter
    PATH_PARAMETER
    QueryParameter
    QUERY_PARAMETER
    RequestHeader
    REQUEST_HEADER
    RequestBody
    REQUEST_BODY
    Response
    RESPONSE
    ResponseHeader
    RESPONSE_HEADER
    ResponseBody
    RESPONSE_BODY
    DocumentationPartLocationTypeApi
    API
    DocumentationPartLocationTypeAuthorizer
    AUTHORIZER
    DocumentationPartLocationTypeModel
    MODEL
    DocumentationPartLocationTypeResource
    RESOURCE
    DocumentationPartLocationTypeMethod
    METHOD
    DocumentationPartLocationTypePathParameter
    PATH_PARAMETER
    DocumentationPartLocationTypeQueryParameter
    QUERY_PARAMETER
    DocumentationPartLocationTypeRequestHeader
    REQUEST_HEADER
    DocumentationPartLocationTypeRequestBody
    REQUEST_BODY
    DocumentationPartLocationTypeResponse
    RESPONSE
    DocumentationPartLocationTypeResponseHeader
    RESPONSE_HEADER
    DocumentationPartLocationTypeResponseBody
    RESPONSE_BODY
    Api
    API
    Authorizer
    AUTHORIZER
    Model
    MODEL
    Resource
    RESOURCE
    Method
    METHOD
    PathParameter
    PATH_PARAMETER
    QueryParameter
    QUERY_PARAMETER
    RequestHeader
    REQUEST_HEADER
    RequestBody
    REQUEST_BODY
    Response
    RESPONSE
    ResponseHeader
    RESPONSE_HEADER
    ResponseBody
    RESPONSE_BODY
    Api
    API
    Authorizer
    AUTHORIZER
    Model
    MODEL
    Resource
    RESOURCE
    Method
    METHOD
    PathParameter
    PATH_PARAMETER
    QueryParameter
    QUERY_PARAMETER
    RequestHeader
    REQUEST_HEADER
    RequestBody
    REQUEST_BODY
    Response
    RESPONSE
    ResponseHeader
    RESPONSE_HEADER
    ResponseBody
    RESPONSE_BODY
    API
    API
    AUTHORIZER
    AUTHORIZER
    MODEL
    MODEL
    RESOURCE
    RESOURCE
    METHOD
    METHOD
    PATH_PARAMETER
    PATH_PARAMETER
    QUERY_PARAMETER
    QUERY_PARAMETER
    REQUEST_HEADER
    REQUEST_HEADER
    REQUEST_BODY
    REQUEST_BODY
    RESPONSE
    RESPONSE
    RESPONSE_HEADER
    RESPONSE_HEADER
    RESPONSE_BODY
    RESPONSE_BODY
    "API"
    API
    "AUTHORIZER"
    AUTHORIZER
    "MODEL"
    MODEL
    "RESOURCE"
    RESOURCE
    "METHOD"
    METHOD
    "PATH_PARAMETER"
    PATH_PARAMETER
    "QUERY_PARAMETER"
    QUERY_PARAMETER
    "REQUEST_HEADER"
    REQUEST_HEADER
    "REQUEST_BODY"
    REQUEST_BODY
    "RESPONSE"
    RESPONSE
    "RESPONSE_HEADER"
    RESPONSE_HEADER
    "RESPONSE_BODY"
    RESPONSE_BODY

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    AWS Native is in preview. AWS Classic is fully supported.

    AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi