RestAPI

apigateway.services.k8s.aws/v1alpha1

TypeLink
GoDocapigateway-controller/apis/v1alpha1#RestAPI

Metadata

PropertyValue
ScopeNamespaced
KindRestAPI
ListKindRestAPIList
Pluralrestapis
Singularrestapi

Represents a REST API.

Spec

apiKeySource: string
binaryMediaTypes:
- string
cloneFrom: string
description: string
disableExecuteAPIEndpoint: boolean
endpointConfiguration: 
  types:
  - string
  vpcEndpointIDs:
  - string
  vpcEndpointRefs:
    from: 
      name: string
      namespace: string
minimumCompressionSize: integer
name: string
policy: string
tags: {}
version: string
FieldDescription
apiKeySource
Optional
string
The source of the API key for metering requests according to a usage plan.
Valid values are: HEADER to read the API key from the X-API-Key header of
a request. AUTHORIZER to read the API key from the UsageIdentifierKey from
a custom authorizer.
binaryMediaTypes
Optional
array
The list of binary media types supported by the RestApi. By default, the
RestApi supports only UTF-8-encoded text payloads.
binaryMediaTypes.[]
Required
string
description
Optional
string
The description of the RestApi.
disableExecuteAPIEndpoint
Optional
boolean
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
endpointConfiguration
Optional
object
The endpoint configuration of this RestApi showing the endpoint types of
the API.
endpointConfiguration.types
Optional
array
endpointConfiguration.types.[]
Required
string
endpointConfiguration.vpcEndpointIDs.[]
Required
string
endpointConfiguration.vpcEndpointRefs.[]
Required
object
AWSResourceReferenceWrapper provides a wrapper around *AWSResourceReference
type to provide more user friendly syntax for references using ‘from’ field
Ex:
APIIDRef:
from:
  name: my-api || **endpointConfiguration.vpcEndpointRefs.[].from**<br/>Optional | **object**<br/>AWSResourceReference provides all the values necessary to reference another<br/>k8s resource for finding the identifier(Id/ARN/Name) |

| endpointConfiguration.vpcEndpointRefs.[].from.name
Optional | string
| | endpointConfiguration.vpcEndpointRefs.[].from.namespace
Optional | string
| | minimumCompressionSize
Optional | integer
A nullable integer that is used to enable compression (with non-negative
between 0 and 10485760 (10M) bytes, inclusive) or disable compression (with
a null value) on an API. When compression is enabled, compression or decompression
is not applied on the payload if the payload size is smaller than this value.
Setting it to zero allows compression for any payload size. | | name
Required | string
The name of the RestApi. | | policy
Optional | string
A stringified JSON policy document that applies to this RestApi regardless
of the caller and Method configuration. | | tags
Optional | object
The key-value map of strings. The valid character set is [a-zA-Z+-=._:/].
The tag key can be up to 128 characters and must not start with aws:. The
tag value can be up to 256 characters. | | version
Optional | string
A version identifier for the API. |

Status

ackResourceMetadata: 
  arn: string
  ownerAccountID: string
  region: string
conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
createdDate: string
id: string
rootResourceID: string
warnings:
- string
FieldDescription
ackResourceMetadata
Optional
object
All CRs managed by ACK have a common Status.ACKResourceMetadata member
that is used to contain resource sync state, account ownership,
constructed ARN for the resource
ackResourceMetadata.arn
Optional
string
ARN is the Amazon Resource Name for the resource. This is a
globally-unique identifier and is set only by the ACK service controller
once the controller has orchestrated the creation of the resource OR
when it has verified that an “adopted” resource (a resource where the
ARN annotation was set by the Kubernetes user on the CR) exists and
matches the supplied CR’s Spec field values.
TODO(vijat@): Find a better strategy for resources that do not have ARN in CreateOutputResponse
https://github.com/aws/aws-controllers-k8s/issues/270
ackResourceMetadata.ownerAccountID
Required
string
OwnerAccountID is the AWS Account ID of the account that owns the
backend AWS service API resource.
ackResourceMetadata.region
Required
string
Region is the AWS region in which the resource exists or will exist.
conditions
Optional
array
All CRS managed by ACK have a common Status.Conditions member that
contains a collection of ackv1alpha1.Condition objects that describe
the various terminal states of the CR and its backend AWS service API
resource
conditions.[]
Required
object
Condition is the common struct used by all CRDs managed by ACK service
controllers to indicate terminal states of the CR and its backend AWS
service API resource
conditions.[].message
Optional
string
A human readable message indicating details about the transition.
conditions.[].reason
Optional
string
The reason for the condition’s last transition.
conditions.[].status
Optional
string
Status of the condition, one of True, False, Unknown.
conditions.[].type
Optional
string
Type is the type of the Condition
createdDate
Optional
string
The timestamp when the API was created.
id
Optional
string
The API’s identifier. This identifier is unique across all of your APIs in
API Gateway.
rootResourceID
Optional
string
The API’s root resource ID.
warnings
Optional
array
The warning messages reported when failonwarnings is turned on during API
import.
warnings.[]
Required
string