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
cloneFromRef:
from:
name: string
namespace: string
description: string
disableExecuteAPIEndpoint: boolean
endpointAccessMode: string
endpointConfiguration:
ipAddressType: string
types:
- string
vpcEndpointIDs:
- string
vpcEndpointRefs:
from:
name: string
namespace: string
minimumCompressionSize: integer
name: string
policy: string
securityPolicy: 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 |
| cloneFromRef Optional | 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 |
| cloneFromRef.from Optional | object AWSResourceReference provides all the values necessary to reference another k8s resource for finding the identifier(Id/ARN/Name) |
| cloneFromRef.from.name Optional | string |
| cloneFromRef.from.namespace Optional | 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 |
| endpointAccessMode Optional | string The endpoint access mode of the RestApi. Only available for RestApis that use security policies that start with SecurityPolicy_. |
| endpointConfiguration Optional | object The endpoint configuration of this RestApi showing the endpoint types and IP address types of the API. |
| endpointConfiguration.ipAddressType Optional | string |
| 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. |
| securityPolicy
Optional | string
The Transport Layer Security (TLS) version + cipher suite for this RestApi. |
| 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
partition: string
region: string
apiStatus: string
apiStatusMessage: 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.partition Optional | string Partition is the AWS partition in which the resource exists or will exist |
| ackResourceMetadata.region Required | string Region is the AWS region in which the resource exists or will exist. |
| apiStatus Optional | string The ApiStatus of the RestApi. |
| apiStatusMessage Optional | string The status message of the RestApi. When the status message is UPDATING you can still invoke it. |
| 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 |