RestAPI
apigateway.services.k8s.aws/v1alpha1
Type | Link |
---|---|
GoDoc | apigateway-controller/apis/v1alpha1#RestAPI |
Metadata
Property | Value |
---|---|
Scope | Namespaced |
Kind | RestAPI |
ListKind | RestAPIList |
Plural | restapis |
Singular | restapi |
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
Field | Description |
---|---|
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
Field | Description |
---|---|
ackResourceMetadata Optional | object All CRs managed by ACK have a common Status.ACKResourceMetadata memberthat 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. 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 thatcontains a collection of ackv1alpha1.Condition objects that describethe 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 |