package apigateway
import "github.com/aws/aws-sdk-go-v2/service/apigateway"
Package apigateway provides the client and types for making API requests to Amazon API Gateway.
Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.
See apigateway package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/apigateway/
Using the Client
To use Amazon API Gateway with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.
See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/
See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
See the Amazon API Gateway client for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/apigateway/#New
Index ¶
- Constants
- type AccessLogSettings
- func (s AccessLogSettings) MarshalFields(e protocol.FieldEncoder) error
- func (s AccessLogSettings) String() string
- type ApiKey
- type ApiKeySourceType
- func (enum ApiKeySourceType) MarshalValue() (string, error)
- func (enum ApiKeySourceType) MarshalValueBuf(b []byte) ([]byte, error)
- type ApiKeysFormat
- func (enum ApiKeysFormat) MarshalValue() (string, error)
- func (enum ApiKeysFormat) MarshalValueBuf(b []byte) ([]byte, error)
- type ApiStage
- type Authorizer
- func (s Authorizer) MarshalFields(e protocol.FieldEncoder) error
- func (s Authorizer) String() string
- type AuthorizerType
- func (enum AuthorizerType) MarshalValue() (string, error)
- func (enum AuthorizerType) MarshalValueBuf(b []byte) ([]byte, error)
- type BasePathMapping
- func (s BasePathMapping) MarshalFields(e protocol.FieldEncoder) error
- func (s BasePathMapping) String() string
- type CacheClusterSize
- func (enum CacheClusterSize) MarshalValue() (string, error)
- func (enum CacheClusterSize) MarshalValueBuf(b []byte) ([]byte, error)
- type CacheClusterStatus
- func (enum CacheClusterStatus) MarshalValue() (string, error)
- func (enum CacheClusterStatus) MarshalValueBuf(b []byte) ([]byte, error)
- type CanarySettings
- func (s CanarySettings) MarshalFields(e protocol.FieldEncoder) error
- func (s CanarySettings) String() string
- type Certificate
- func (s Certificate) MarshalFields(e protocol.FieldEncoder) error
- func (s Certificate) String() string
- type Client
- func New(config aws.Config) *Client
- func (c *Client) CreateApiKeyRequest(input *CreateApiKeyInput) CreateApiKeyRequest
- func (c *Client) CreateAuthorizerRequest(input *CreateAuthorizerInput) CreateAuthorizerRequest
- func (c *Client) CreateBasePathMappingRequest(input *CreateBasePathMappingInput) CreateBasePathMappingRequest
- func (c *Client) CreateDeploymentRequest(input *CreateDeploymentInput) CreateDeploymentRequest
- func (c *Client) CreateDocumentationPartRequest(input *CreateDocumentationPartInput) CreateDocumentationPartRequest
- func (c *Client) CreateDocumentationVersionRequest(input *CreateDocumentationVersionInput) CreateDocumentationVersionRequest
- func (c *Client) CreateDomainNameRequest(input *CreateDomainNameInput) CreateDomainNameRequest
- func (c *Client) CreateModelRequest(input *CreateModelInput) CreateModelRequest
- func (c *Client) CreateRequestValidatorRequest(input *CreateRequestValidatorInput) CreateRequestValidatorRequest
- func (c *Client) CreateResourceRequest(input *CreateResourceInput) CreateResourceRequest
- func (c *Client) CreateRestApiRequest(input *CreateRestApiInput) CreateRestApiRequest
- func (c *Client) CreateStageRequest(input *CreateStageInput) CreateStageRequest
- func (c *Client) CreateUsagePlanKeyRequest(input *CreateUsagePlanKeyInput) CreateUsagePlanKeyRequest
- func (c *Client) CreateUsagePlanRequest(input *CreateUsagePlanInput) CreateUsagePlanRequest
- func (c *Client) CreateVpcLinkRequest(input *CreateVpcLinkInput) CreateVpcLinkRequest
- func (c *Client) DeleteApiKeyRequest(input *DeleteApiKeyInput) DeleteApiKeyRequest
- func (c *Client) DeleteAuthorizerRequest(input *DeleteAuthorizerInput) DeleteAuthorizerRequest
- func (c *Client) DeleteBasePathMappingRequest(input *DeleteBasePathMappingInput) DeleteBasePathMappingRequest
- func (c *Client) DeleteClientCertificateRequest(input *DeleteClientCertificateInput) DeleteClientCertificateRequest
- func (c *Client) DeleteDeploymentRequest(input *DeleteDeploymentInput) DeleteDeploymentRequest
- func (c *Client) DeleteDocumentationPartRequest(input *DeleteDocumentationPartInput) DeleteDocumentationPartRequest
- func (c *Client) DeleteDocumentationVersionRequest(input *DeleteDocumentationVersionInput) DeleteDocumentationVersionRequest
- func (c *Client) DeleteDomainNameRequest(input *DeleteDomainNameInput) DeleteDomainNameRequest
- func (c *Client) DeleteGatewayResponseRequest(input *DeleteGatewayResponseInput) DeleteGatewayResponseRequest
- func (c *Client) DeleteIntegrationRequest(input *DeleteIntegrationInput) DeleteIntegrationRequest
- func (c *Client) DeleteIntegrationResponseRequest(input *DeleteIntegrationResponseInput) DeleteIntegrationResponseRequest
- func (c *Client) DeleteMethodRequest(input *DeleteMethodInput) DeleteMethodRequest
- func (c *Client) DeleteMethodResponseRequest(input *DeleteMethodResponseInput) DeleteMethodResponseRequest
- func (c *Client) DeleteModelRequest(input *DeleteModelInput) DeleteModelRequest
- func (c *Client) DeleteRequestValidatorRequest(input *DeleteRequestValidatorInput) DeleteRequestValidatorRequest
- func (c *Client) DeleteResourceRequest(input *DeleteResourceInput) DeleteResourceRequest
- func (c *Client) DeleteRestApiRequest(input *DeleteRestApiInput) DeleteRestApiRequest
- func (c *Client) DeleteStageRequest(input *DeleteStageInput) DeleteStageRequest
- func (c *Client) DeleteUsagePlanKeyRequest(input *DeleteUsagePlanKeyInput) DeleteUsagePlanKeyRequest
- func (c *Client) DeleteUsagePlanRequest(input *DeleteUsagePlanInput) DeleteUsagePlanRequest
- func (c *Client) DeleteVpcLinkRequest(input *DeleteVpcLinkInput) DeleteVpcLinkRequest
- func (c *Client) FlushStageAuthorizersCacheRequest(input *FlushStageAuthorizersCacheInput) FlushStageAuthorizersCacheRequest
- func (c *Client) FlushStageCacheRequest(input *FlushStageCacheInput) FlushStageCacheRequest
- func (c *Client) GenerateClientCertificateRequest(input *GenerateClientCertificateInput) GenerateClientCertificateRequest
- func (c *Client) GetAccountRequest(input *GetAccountInput) GetAccountRequest
- func (c *Client) GetApiKeyRequest(input *GetApiKeyInput) GetApiKeyRequest
- func (c *Client) GetApiKeysRequest(input *GetApiKeysInput) GetApiKeysRequest
- func (c *Client) GetAuthorizerRequest(input *GetAuthorizerInput) GetAuthorizerRequest
- func (c *Client) GetAuthorizersRequest(input *GetAuthorizersInput) GetAuthorizersRequest
- func (c *Client) GetBasePathMappingRequest(input *GetBasePathMappingInput) GetBasePathMappingRequest
- func (c *Client) GetBasePathMappingsRequest(input *GetBasePathMappingsInput) GetBasePathMappingsRequest
- func (c *Client) GetClientCertificateRequest(input *GetClientCertificateInput) GetClientCertificateRequest
- func (c *Client) GetClientCertificatesRequest(input *GetClientCertificatesInput) GetClientCertificatesRequest
- func (c *Client) GetDeploymentRequest(input *GetDeploymentInput) GetDeploymentRequest
- func (c *Client) GetDeploymentsRequest(input *GetDeploymentsInput) GetDeploymentsRequest
- func (c *Client) GetDocumentationPartRequest(input *GetDocumentationPartInput) GetDocumentationPartRequest
- func (c *Client) GetDocumentationPartsRequest(input *GetDocumentationPartsInput) GetDocumentationPartsRequest
- func (c *Client) GetDocumentationVersionRequest(input *GetDocumentationVersionInput) GetDocumentationVersionRequest
- func (c *Client) GetDocumentationVersionsRequest(input *GetDocumentationVersionsInput) GetDocumentationVersionsRequest
- func (c *Client) GetDomainNameRequest(input *GetDomainNameInput) GetDomainNameRequest
- func (c *Client) GetDomainNamesRequest(input *GetDomainNamesInput) GetDomainNamesRequest
- func (c *Client) GetExportRequest(input *GetExportInput) GetExportRequest
- func (c *Client) GetGatewayResponseRequest(input *GetGatewayResponseInput) GetGatewayResponseRequest
- func (c *Client) GetGatewayResponsesRequest(input *GetGatewayResponsesInput) GetGatewayResponsesRequest
- func (c *Client) GetIntegrationRequest(input *GetIntegrationInput) GetIntegrationRequest
- func (c *Client) GetIntegrationResponseRequest(input *GetIntegrationResponseInput) GetIntegrationResponseRequest
- func (c *Client) GetMethodRequest(input *GetMethodInput) GetMethodRequest
- func (c *Client) GetMethodResponseRequest(input *GetMethodResponseInput) GetMethodResponseRequest
- func (c *Client) GetModelRequest(input *GetModelInput) GetModelRequest
- func (c *Client) GetModelTemplateRequest(input *GetModelTemplateInput) GetModelTemplateRequest
- func (c *Client) GetModelsRequest(input *GetModelsInput) GetModelsRequest
- func (c *Client) GetRequestValidatorRequest(input *GetRequestValidatorInput) GetRequestValidatorRequest
- func (c *Client) GetRequestValidatorsRequest(input *GetRequestValidatorsInput) GetRequestValidatorsRequest
- func (c *Client) GetResourceRequest(input *GetResourceInput) GetResourceRequest
- func (c *Client) GetResourcesRequest(input *GetResourcesInput) GetResourcesRequest
- func (c *Client) GetRestApiRequest(input *GetRestApiInput) GetRestApiRequest
- func (c *Client) GetRestApisRequest(input *GetRestApisInput) GetRestApisRequest
- func (c *Client) GetSdkRequest(input *GetSdkInput) GetSdkRequest
- func (c *Client) GetSdkTypeRequest(input *GetSdkTypeInput) GetSdkTypeRequest
- func (c *Client) GetSdkTypesRequest(input *GetSdkTypesInput) GetSdkTypesRequest
- func (c *Client) GetStageRequest(input *GetStageInput) GetStageRequest
- func (c *Client) GetStagesRequest(input *GetStagesInput) GetStagesRequest
- func (c *Client) GetTagsRequest(input *GetTagsInput) GetTagsRequest
- func (c *Client) GetUsagePlanKeyRequest(input *GetUsagePlanKeyInput) GetUsagePlanKeyRequest
- func (c *Client) GetUsagePlanKeysRequest(input *GetUsagePlanKeysInput) GetUsagePlanKeysRequest
- func (c *Client) GetUsagePlanRequest(input *GetUsagePlanInput) GetUsagePlanRequest
- func (c *Client) GetUsagePlansRequest(input *GetUsagePlansInput) GetUsagePlansRequest
- func (c *Client) GetUsageRequest(input *GetUsageInput) GetUsageRequest
- func (c *Client) GetVpcLinkRequest(input *GetVpcLinkInput) GetVpcLinkRequest
- func (c *Client) GetVpcLinksRequest(input *GetVpcLinksInput) GetVpcLinksRequest
- func (c *Client) ImportApiKeysRequest(input *ImportApiKeysInput) ImportApiKeysRequest
- func (c *Client) ImportDocumentationPartsRequest(input *ImportDocumentationPartsInput) ImportDocumentationPartsRequest
- func (c *Client) ImportRestApiRequest(input *ImportRestApiInput) ImportRestApiRequest
- func (c *Client) PutGatewayResponseRequest(input *PutGatewayResponseInput) PutGatewayResponseRequest
- func (c *Client) PutIntegrationRequest(input *PutIntegrationInput) PutIntegrationRequest
- func (c *Client) PutIntegrationResponseRequest(input *PutIntegrationResponseInput) PutIntegrationResponseRequest
- func (c *Client) PutMethodRequest(input *PutMethodInput) PutMethodRequest
- func (c *Client) PutMethodResponseRequest(input *PutMethodResponseInput) PutMethodResponseRequest
- func (c *Client) PutRestApiRequest(input *PutRestApiInput) PutRestApiRequest
- func (c *Client) TagResourceRequest(input *TagResourceInput) TagResourceRequest
- func (c *Client) TestInvokeAuthorizerRequest(input *TestInvokeAuthorizerInput) TestInvokeAuthorizerRequest
- func (c *Client) TestInvokeMethodRequest(input *TestInvokeMethodInput) TestInvokeMethodRequest
- func (c *Client) UntagResourceRequest(input *UntagResourceInput) UntagResourceRequest
- func (c *Client) UpdateAccountRequest(input *UpdateAccountInput) UpdateAccountRequest
- func (c *Client) UpdateApiKeyRequest(input *UpdateApiKeyInput) UpdateApiKeyRequest
- func (c *Client) UpdateAuthorizerRequest(input *UpdateAuthorizerInput) UpdateAuthorizerRequest
- func (c *Client) UpdateBasePathMappingRequest(input *UpdateBasePathMappingInput) UpdateBasePathMappingRequest
- func (c *Client) UpdateClientCertificateRequest(input *UpdateClientCertificateInput) UpdateClientCertificateRequest
- func (c *Client) UpdateDeploymentRequest(input *UpdateDeploymentInput) UpdateDeploymentRequest
- func (c *Client) UpdateDocumentationPartRequest(input *UpdateDocumentationPartInput) UpdateDocumentationPartRequest
- func (c *Client) UpdateDocumentationVersionRequest(input *UpdateDocumentationVersionInput) UpdateDocumentationVersionRequest
- func (c *Client) UpdateDomainNameRequest(input *UpdateDomainNameInput) UpdateDomainNameRequest
- func (c *Client) UpdateGatewayResponseRequest(input *UpdateGatewayResponseInput) UpdateGatewayResponseRequest
- func (c *Client) UpdateIntegrationRequest(input *UpdateIntegrationInput) UpdateIntegrationRequest
- func (c *Client) UpdateIntegrationResponseRequest(input *UpdateIntegrationResponseInput) UpdateIntegrationResponseRequest
- func (c *Client) UpdateMethodRequest(input *UpdateMethodInput) UpdateMethodRequest
- func (c *Client) UpdateMethodResponseRequest(input *UpdateMethodResponseInput) UpdateMethodResponseRequest
- func (c *Client) UpdateModelRequest(input *UpdateModelInput) UpdateModelRequest
- func (c *Client) UpdateRequestValidatorRequest(input *UpdateRequestValidatorInput) UpdateRequestValidatorRequest
- func (c *Client) UpdateResourceRequest(input *UpdateResourceInput) UpdateResourceRequest
- func (c *Client) UpdateRestApiRequest(input *UpdateRestApiInput) UpdateRestApiRequest
- func (c *Client) UpdateStageRequest(input *UpdateStageInput) UpdateStageRequest
- func (c *Client) UpdateUsagePlanRequest(input *UpdateUsagePlanInput) UpdateUsagePlanRequest
- func (c *Client) UpdateUsageRequest(input *UpdateUsageInput) UpdateUsageRequest
- func (c *Client) UpdateVpcLinkRequest(input *UpdateVpcLinkInput) UpdateVpcLinkRequest
- type ConnectionType
- func (enum ConnectionType) MarshalValue() (string, error)
- func (enum ConnectionType) MarshalValueBuf(b []byte) ([]byte, error)
- type ContentHandlingStrategy
- func (enum ContentHandlingStrategy) MarshalValue() (string, error)
- func (enum ContentHandlingStrategy) MarshalValueBuf(b []byte) ([]byte, error)
- type CreateApiKeyInput
- func (s CreateApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateApiKeyInput) String() string
- type CreateApiKeyOutput
- func (s CreateApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateApiKeyOutput) String() string
- type CreateApiKeyRequest
- type CreateApiKeyResponse
- type CreateAuthorizerInput
- func (s CreateAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateAuthorizerInput) String() string
- func (s *CreateAuthorizerInput) Validate() error
- type CreateAuthorizerOutput
- func (s CreateAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateAuthorizerOutput) String() string
- type CreateAuthorizerRequest
- type CreateAuthorizerResponse
- type CreateBasePathMappingInput
- func (s CreateBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateBasePathMappingInput) String() string
- func (s *CreateBasePathMappingInput) Validate() error
- type CreateBasePathMappingOutput
- func (s CreateBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateBasePathMappingOutput) String() string
- type CreateBasePathMappingRequest
- type CreateBasePathMappingResponse
- type CreateDeploymentInput
- func (s CreateDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDeploymentInput) String() string
- func (s *CreateDeploymentInput) Validate() error
- type CreateDeploymentOutput
- func (s CreateDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDeploymentOutput) String() string
- type CreateDeploymentRequest
- type CreateDeploymentResponse
- type CreateDocumentationPartInput
- func (s CreateDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDocumentationPartInput) String() string
- func (s *CreateDocumentationPartInput) Validate() error
- type CreateDocumentationPartOutput
- func (s CreateDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDocumentationPartOutput) String() string
- type CreateDocumentationPartRequest
- type CreateDocumentationPartResponse
- type CreateDocumentationVersionInput
- func (s CreateDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDocumentationVersionInput) String() string
- func (s *CreateDocumentationVersionInput) Validate() error
- type CreateDocumentationVersionOutput
- func (s CreateDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDocumentationVersionOutput) String() string
- type CreateDocumentationVersionRequest
- type CreateDocumentationVersionResponse
- type CreateDomainNameInput
- func (s CreateDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDomainNameInput) String() string
- func (s *CreateDomainNameInput) Validate() error
- type CreateDomainNameOutput
- func (s CreateDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateDomainNameOutput) String() string
- type CreateDomainNameRequest
- type CreateDomainNameResponse
- type CreateModelInput
- func (s CreateModelInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateModelInput) String() string
- func (s *CreateModelInput) Validate() error
- type CreateModelOutput
- func (s CreateModelOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateModelOutput) String() string
- type CreateModelRequest
- type CreateModelResponse
- type CreateRequestValidatorInput
- func (s CreateRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateRequestValidatorInput) String() string
- func (s *CreateRequestValidatorInput) Validate() error
- type CreateRequestValidatorOutput
- func (s CreateRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateRequestValidatorOutput) String() string
- type CreateRequestValidatorRequest
- type CreateRequestValidatorResponse
- type CreateResourceInput
- func (s CreateResourceInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateResourceInput) String() string
- func (s *CreateResourceInput) Validate() error
- type CreateResourceOutput
- func (s CreateResourceOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateResourceOutput) String() string
- type CreateResourceRequest
- type CreateResourceResponse
- type CreateRestApiInput
- func (s CreateRestApiInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateRestApiInput) String() string
- func (s *CreateRestApiInput) Validate() error
- type CreateRestApiOutput
- func (s CreateRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateRestApiOutput) String() string
- type CreateRestApiRequest
- type CreateRestApiResponse
- type CreateStageInput
- func (s CreateStageInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateStageInput) String() string
- func (s *CreateStageInput) Validate() error
- type CreateStageOutput
- func (s CreateStageOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateStageOutput) String() string
- type CreateStageRequest
- type CreateStageResponse
- type CreateUsagePlanInput
- func (s CreateUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateUsagePlanInput) String() string
- func (s *CreateUsagePlanInput) Validate() error
- type CreateUsagePlanKeyInput
- func (s CreateUsagePlanKeyInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateUsagePlanKeyInput) String() string
- func (s *CreateUsagePlanKeyInput) Validate() error
- type CreateUsagePlanKeyOutput
- func (s CreateUsagePlanKeyOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateUsagePlanKeyOutput) String() string
- type CreateUsagePlanKeyRequest
- type CreateUsagePlanKeyResponse
- type CreateUsagePlanOutput
- func (s CreateUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateUsagePlanOutput) String() string
- type CreateUsagePlanRequest
- type CreateUsagePlanResponse
- type CreateVpcLinkInput
- func (s CreateVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateVpcLinkInput) String() string
- func (s *CreateVpcLinkInput) Validate() error
- type CreateVpcLinkOutput
- func (s CreateVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s CreateVpcLinkOutput) String() string
- type CreateVpcLinkRequest
- type CreateVpcLinkResponse
- type DeleteApiKeyInput
- func (s DeleteApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteApiKeyInput) String() string
- func (s *DeleteApiKeyInput) Validate() error
- type DeleteApiKeyOutput
- func (s DeleteApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteApiKeyOutput) String() string
- type DeleteApiKeyRequest
- type DeleteApiKeyResponse
- type DeleteAuthorizerInput
- func (s DeleteAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteAuthorizerInput) String() string
- func (s *DeleteAuthorizerInput) Validate() error
- type DeleteAuthorizerOutput
- func (s DeleteAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteAuthorizerOutput) String() string
- type DeleteAuthorizerRequest
- type DeleteAuthorizerResponse
- type DeleteBasePathMappingInput
- func (s DeleteBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteBasePathMappingInput) String() string
- func (s *DeleteBasePathMappingInput) Validate() error
- type DeleteBasePathMappingOutput
- func (s DeleteBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteBasePathMappingOutput) String() string
- type DeleteBasePathMappingRequest
- type DeleteBasePathMappingResponse
- type DeleteClientCertificateInput
- func (s DeleteClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteClientCertificateInput) String() string
- func (s *DeleteClientCertificateInput) Validate() error
- type DeleteClientCertificateOutput
- func (s DeleteClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteClientCertificateOutput) String() string
- type DeleteClientCertificateRequest
- type DeleteClientCertificateResponse
- type DeleteDeploymentInput
- func (s DeleteDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDeploymentInput) String() string
- func (s *DeleteDeploymentInput) Validate() error
- type DeleteDeploymentOutput
- func (s DeleteDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDeploymentOutput) String() string
- type DeleteDeploymentRequest
- type DeleteDeploymentResponse
- type DeleteDocumentationPartInput
- func (s DeleteDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDocumentationPartInput) String() string
- func (s *DeleteDocumentationPartInput) Validate() error
- type DeleteDocumentationPartOutput
- func (s DeleteDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDocumentationPartOutput) String() string
- type DeleteDocumentationPartRequest
- type DeleteDocumentationPartResponse
- type DeleteDocumentationVersionInput
- func (s DeleteDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDocumentationVersionInput) String() string
- func (s *DeleteDocumentationVersionInput) Validate() error
- type DeleteDocumentationVersionOutput
- func (s DeleteDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDocumentationVersionOutput) String() string
- type DeleteDocumentationVersionRequest
- type DeleteDocumentationVersionResponse
- type DeleteDomainNameInput
- func (s DeleteDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDomainNameInput) String() string
- func (s *DeleteDomainNameInput) Validate() error
- type DeleteDomainNameOutput
- func (s DeleteDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteDomainNameOutput) String() string
- type DeleteDomainNameRequest
- type DeleteDomainNameResponse
- type DeleteGatewayResponseInput
- func (s DeleteGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteGatewayResponseInput) String() string
- func (s *DeleteGatewayResponseInput) Validate() error
- type DeleteGatewayResponseOutput
- func (s DeleteGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteGatewayResponseOutput) String() string
- type DeleteGatewayResponseRequest
- type DeleteGatewayResponseResponse
- type DeleteIntegrationInput
- func (s DeleteIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteIntegrationInput) String() string
- func (s *DeleteIntegrationInput) Validate() error
- type DeleteIntegrationOutput
- func (s DeleteIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteIntegrationOutput) String() string
- type DeleteIntegrationRequest
- type DeleteIntegrationResponse
- type DeleteIntegrationResponseInput
- func (s DeleteIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteIntegrationResponseInput) String() string
- func (s *DeleteIntegrationResponseInput) Validate() error
- type DeleteIntegrationResponseOutput
- func (s DeleteIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteIntegrationResponseOutput) String() string
- type DeleteIntegrationResponseRequest
- type DeleteIntegrationResponseResponse
- type DeleteMethodInput
- func (s DeleteMethodInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteMethodInput) String() string
- func (s *DeleteMethodInput) Validate() error
- type DeleteMethodOutput
- func (s DeleteMethodOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteMethodOutput) String() string
- type DeleteMethodRequest
- type DeleteMethodResponse
- type DeleteMethodResponseInput
- func (s DeleteMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteMethodResponseInput) String() string
- func (s *DeleteMethodResponseInput) Validate() error
- type DeleteMethodResponseOutput
- func (s DeleteMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteMethodResponseOutput) String() string
- type DeleteMethodResponseRequest
- type DeleteMethodResponseResponse
- type DeleteModelInput
- func (s DeleteModelInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteModelInput) String() string
- func (s *DeleteModelInput) Validate() error
- type DeleteModelOutput
- func (s DeleteModelOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteModelOutput) String() string
- type DeleteModelRequest
- type DeleteModelResponse
- type DeleteRequestValidatorInput
- func (s DeleteRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteRequestValidatorInput) String() string
- func (s *DeleteRequestValidatorInput) Validate() error
- type DeleteRequestValidatorOutput
- func (s DeleteRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteRequestValidatorOutput) String() string
- type DeleteRequestValidatorRequest
- type DeleteRequestValidatorResponse
- type DeleteResourceInput
- func (s DeleteResourceInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteResourceInput) String() string
- func (s *DeleteResourceInput) Validate() error
- type DeleteResourceOutput
- func (s DeleteResourceOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteResourceOutput) String() string
- type DeleteResourceRequest
- type DeleteResourceResponse
- type DeleteRestApiInput
- func (s DeleteRestApiInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteRestApiInput) String() string
- func (s *DeleteRestApiInput) Validate() error
- type DeleteRestApiOutput
- func (s DeleteRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteRestApiOutput) String() string
- type DeleteRestApiRequest
- type DeleteRestApiResponse
- type DeleteStageInput
- func (s DeleteStageInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteStageInput) String() string
- func (s *DeleteStageInput) Validate() error
- type DeleteStageOutput
- func (s DeleteStageOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteStageOutput) String() string
- type DeleteStageRequest
- type DeleteStageResponse
- type DeleteUsagePlanInput
- func (s DeleteUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteUsagePlanInput) String() string
- func (s *DeleteUsagePlanInput) Validate() error
- type DeleteUsagePlanKeyInput
- func (s DeleteUsagePlanKeyInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteUsagePlanKeyInput) String() string
- func (s *DeleteUsagePlanKeyInput) Validate() error
- type DeleteUsagePlanKeyOutput
- func (s DeleteUsagePlanKeyOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteUsagePlanKeyOutput) String() string
- type DeleteUsagePlanKeyRequest
- type DeleteUsagePlanKeyResponse
- type DeleteUsagePlanOutput
- func (s DeleteUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteUsagePlanOutput) String() string
- type DeleteUsagePlanRequest
- type DeleteUsagePlanResponse
- type DeleteVpcLinkInput
- func (s DeleteVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteVpcLinkInput) String() string
- func (s *DeleteVpcLinkInput) Validate() error
- type DeleteVpcLinkOutput
- func (s DeleteVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s DeleteVpcLinkOutput) String() string
- type DeleteVpcLinkRequest
- type DeleteVpcLinkResponse
- type Deployment
- func (s Deployment) MarshalFields(e protocol.FieldEncoder) error
- func (s Deployment) String() string
- type DeploymentCanarySettings
- func (s DeploymentCanarySettings) MarshalFields(e protocol.FieldEncoder) error
- func (s DeploymentCanarySettings) String() string
- type DocumentationPart
- func (s DocumentationPart) MarshalFields(e protocol.FieldEncoder) error
- func (s DocumentationPart) String() string
- type DocumentationPartLocation
- func (s DocumentationPartLocation) MarshalFields(e protocol.FieldEncoder) error
- func (s DocumentationPartLocation) String() string
- func (s *DocumentationPartLocation) Validate() error
- type DocumentationPartType
- func (enum DocumentationPartType) MarshalValue() (string, error)
- func (enum DocumentationPartType) MarshalValueBuf(b []byte) ([]byte, error)
- type DocumentationVersion
- func (s DocumentationVersion) MarshalFields(e protocol.FieldEncoder) error
- func (s DocumentationVersion) String() string
- type DomainName
- func (s DomainName) MarshalFields(e protocol.FieldEncoder) error
- func (s DomainName) String() string
- type DomainNameStatus
- func (enum DomainNameStatus) MarshalValue() (string, error)
- func (enum DomainNameStatus) MarshalValueBuf(b []byte) ([]byte, error)
- type EndpointConfiguration
- func (s EndpointConfiguration) MarshalFields(e protocol.FieldEncoder) error
- func (s EndpointConfiguration) String() string
- type EndpointType
- func (enum EndpointType) MarshalValue() (string, error)
- func (enum EndpointType) MarshalValueBuf(b []byte) ([]byte, error)
- type FlushStageAuthorizersCacheInput
- func (s FlushStageAuthorizersCacheInput) MarshalFields(e protocol.FieldEncoder) error
- func (s FlushStageAuthorizersCacheInput) String() string
- func (s *FlushStageAuthorizersCacheInput) Validate() error
- type FlushStageAuthorizersCacheOutput
- func (s FlushStageAuthorizersCacheOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s FlushStageAuthorizersCacheOutput) String() string
- type FlushStageAuthorizersCacheRequest
- type FlushStageAuthorizersCacheResponse
- type FlushStageCacheInput
- func (s FlushStageCacheInput) MarshalFields(e protocol.FieldEncoder) error
- func (s FlushStageCacheInput) String() string
- func (s *FlushStageCacheInput) Validate() error
- type FlushStageCacheOutput
- func (s FlushStageCacheOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s FlushStageCacheOutput) String() string
- type FlushStageCacheRequest
- type FlushStageCacheResponse
- type GatewayResponse
- func (s GatewayResponse) MarshalFields(e protocol.FieldEncoder) error
- func (s GatewayResponse) String() string
- type GatewayResponseType
- func (enum GatewayResponseType) MarshalValue() (string, error)
- func (enum GatewayResponseType) MarshalValueBuf(b []byte) ([]byte, error)
- type GenerateClientCertificateInput
- func (s GenerateClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GenerateClientCertificateInput) String() string
- type GenerateClientCertificateOutput
- func (s GenerateClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GenerateClientCertificateOutput) String() string
- type GenerateClientCertificateRequest
- type GenerateClientCertificateResponse
- type GetAccountInput
- func (s GetAccountInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetAccountInput) String() string
- type GetAccountOutput
- func (s GetAccountOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetAccountOutput) String() string
- type GetAccountRequest
- type GetAccountResponse
- type GetApiKeyInput
- func (s GetApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetApiKeyInput) String() string
- func (s *GetApiKeyInput) Validate() error
- type GetApiKeyOutput
- func (s GetApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetApiKeyOutput) String() string
- type GetApiKeyRequest
- type GetApiKeyResponse
- type GetApiKeysInput
- func (s GetApiKeysInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetApiKeysInput) String() string
- type GetApiKeysOutput
- func (s GetApiKeysOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetApiKeysOutput) String() string
- type GetApiKeysPaginator
- func NewGetApiKeysPaginator(req GetApiKeysRequest) GetApiKeysPaginator
- func (p *GetApiKeysPaginator) CurrentPage() *GetApiKeysOutput
- type GetApiKeysRequest
- type GetApiKeysResponse
- type GetAuthorizerInput
- func (s GetAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetAuthorizerInput) String() string
- func (s *GetAuthorizerInput) Validate() error
- type GetAuthorizerOutput
- func (s GetAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetAuthorizerOutput) String() string
- type GetAuthorizerRequest
- type GetAuthorizerResponse
- type GetAuthorizersInput
- func (s GetAuthorizersInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetAuthorizersInput) String() string
- func (s *GetAuthorizersInput) Validate() error
- type GetAuthorizersOutput
- func (s GetAuthorizersOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetAuthorizersOutput) String() string
- type GetAuthorizersRequest
- type GetAuthorizersResponse
- type GetBasePathMappingInput
- func (s GetBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetBasePathMappingInput) String() string
- func (s *GetBasePathMappingInput) Validate() error
- type GetBasePathMappingOutput
- func (s GetBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetBasePathMappingOutput) String() string
- type GetBasePathMappingRequest
- type GetBasePathMappingResponse
- type GetBasePathMappingsInput
- func (s GetBasePathMappingsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetBasePathMappingsInput) String() string
- func (s *GetBasePathMappingsInput) Validate() error
- type GetBasePathMappingsOutput
- func (s GetBasePathMappingsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetBasePathMappingsOutput) String() string
- type GetBasePathMappingsPaginator
- func NewGetBasePathMappingsPaginator(req GetBasePathMappingsRequest) GetBasePathMappingsPaginator
- func (p *GetBasePathMappingsPaginator) CurrentPage() *GetBasePathMappingsOutput
- type GetBasePathMappingsRequest
- type GetBasePathMappingsResponse
- type GetClientCertificateInput
- func (s GetClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetClientCertificateInput) String() string
- func (s *GetClientCertificateInput) Validate() error
- type GetClientCertificateOutput
- func (s GetClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetClientCertificateOutput) String() string
- type GetClientCertificateRequest
- type GetClientCertificateResponse
- type GetClientCertificatesInput
- func (s GetClientCertificatesInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetClientCertificatesInput) String() string
- type GetClientCertificatesOutput
- func (s GetClientCertificatesOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetClientCertificatesOutput) String() string
- type GetClientCertificatesPaginator
- func NewGetClientCertificatesPaginator(req GetClientCertificatesRequest) GetClientCertificatesPaginator
- func (p *GetClientCertificatesPaginator) CurrentPage() *GetClientCertificatesOutput
- type GetClientCertificatesRequest
- type GetClientCertificatesResponse
- type GetDeploymentInput
- func (s GetDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDeploymentInput) String() string
- func (s *GetDeploymentInput) Validate() error
- type GetDeploymentOutput
- func (s GetDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDeploymentOutput) String() string
- type GetDeploymentRequest
- type GetDeploymentResponse
- type GetDeploymentsInput
- func (s GetDeploymentsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDeploymentsInput) String() string
- func (s *GetDeploymentsInput) Validate() error
- type GetDeploymentsOutput
- func (s GetDeploymentsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDeploymentsOutput) String() string
- type GetDeploymentsPaginator
- func NewGetDeploymentsPaginator(req GetDeploymentsRequest) GetDeploymentsPaginator
- func (p *GetDeploymentsPaginator) CurrentPage() *GetDeploymentsOutput
- type GetDeploymentsRequest
- type GetDeploymentsResponse
- type GetDocumentationPartInput
- func (s GetDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationPartInput) String() string
- func (s *GetDocumentationPartInput) Validate() error
- type GetDocumentationPartOutput
- func (s GetDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationPartOutput) String() string
- type GetDocumentationPartRequest
- type GetDocumentationPartResponse
- type GetDocumentationPartsInput
- func (s GetDocumentationPartsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationPartsInput) String() string
- func (s *GetDocumentationPartsInput) Validate() error
- type GetDocumentationPartsOutput
- func (s GetDocumentationPartsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationPartsOutput) String() string
- type GetDocumentationPartsRequest
- type GetDocumentationPartsResponse
- type GetDocumentationVersionInput
- func (s GetDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationVersionInput) String() string
- func (s *GetDocumentationVersionInput) Validate() error
- type GetDocumentationVersionOutput
- func (s GetDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationVersionOutput) String() string
- type GetDocumentationVersionRequest
- type GetDocumentationVersionResponse
- type GetDocumentationVersionsInput
- func (s GetDocumentationVersionsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationVersionsInput) String() string
- func (s *GetDocumentationVersionsInput) Validate() error
- type GetDocumentationVersionsOutput
- func (s GetDocumentationVersionsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDocumentationVersionsOutput) String() string
- type GetDocumentationVersionsRequest
- type GetDocumentationVersionsResponse
- type GetDomainNameInput
- func (s GetDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDomainNameInput) String() string
- func (s *GetDomainNameInput) Validate() error
- type GetDomainNameOutput
- func (s GetDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDomainNameOutput) String() string
- type GetDomainNameRequest
- type GetDomainNameResponse
- type GetDomainNamesInput
- func (s GetDomainNamesInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDomainNamesInput) String() string
- type GetDomainNamesOutput
- func (s GetDomainNamesOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetDomainNamesOutput) String() string
- type GetDomainNamesPaginator
- func NewGetDomainNamesPaginator(req GetDomainNamesRequest) GetDomainNamesPaginator
- func (p *GetDomainNamesPaginator) CurrentPage() *GetDomainNamesOutput
- type GetDomainNamesRequest
- type GetDomainNamesResponse
- type GetExportInput
- func (s GetExportInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetExportInput) String() string
- func (s *GetExportInput) Validate() error
- type GetExportOutput
- func (s GetExportOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetExportOutput) String() string
- type GetExportRequest
- type GetExportResponse
- type GetGatewayResponseInput
- func (s GetGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetGatewayResponseInput) String() string
- func (s *GetGatewayResponseInput) Validate() error
- type GetGatewayResponseOutput
- func (s GetGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetGatewayResponseOutput) String() string
- type GetGatewayResponseRequest
- type GetGatewayResponseResponse
- type GetGatewayResponsesInput
- func (s GetGatewayResponsesInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetGatewayResponsesInput) String() string
- func (s *GetGatewayResponsesInput) Validate() error
- type GetGatewayResponsesOutput
- func (s GetGatewayResponsesOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetGatewayResponsesOutput) String() string
- type GetGatewayResponsesRequest
- type GetGatewayResponsesResponse
- type GetIntegrationInput
- func (s GetIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetIntegrationInput) String() string
- func (s *GetIntegrationInput) Validate() error
- type GetIntegrationOutput
- func (s GetIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetIntegrationOutput) String() string
- type GetIntegrationRequest
- type GetIntegrationResponse
- type GetIntegrationResponseInput
- func (s GetIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetIntegrationResponseInput) String() string
- func (s *GetIntegrationResponseInput) Validate() error
- type GetIntegrationResponseOutput
- func (s GetIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetIntegrationResponseOutput) String() string
- type GetIntegrationResponseRequest
- type GetIntegrationResponseResponse
- type GetMethodInput
- func (s GetMethodInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetMethodInput) String() string
- func (s *GetMethodInput) Validate() error
- type GetMethodOutput
- func (s GetMethodOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetMethodOutput) String() string
- type GetMethodRequest
- type GetMethodResponse
- type GetMethodResponseInput
- func (s GetMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetMethodResponseInput) String() string
- func (s *GetMethodResponseInput) Validate() error
- type GetMethodResponseOutput
- func (s GetMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetMethodResponseOutput) String() string
- type GetMethodResponseRequest
- type GetMethodResponseResponse
- type GetModelInput
- func (s GetModelInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetModelInput) String() string
- func (s *GetModelInput) Validate() error
- type GetModelOutput
- func (s GetModelOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetModelOutput) String() string
- type GetModelRequest
- type GetModelResponse
- type GetModelTemplateInput
- func (s GetModelTemplateInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetModelTemplateInput) String() string
- func (s *GetModelTemplateInput) Validate() error
- type GetModelTemplateOutput
- func (s GetModelTemplateOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetModelTemplateOutput) String() string
- type GetModelTemplateRequest
- type GetModelTemplateResponse
- type GetModelsInput
- func (s GetModelsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetModelsInput) String() string
- func (s *GetModelsInput) Validate() error
- type GetModelsOutput
- func (s GetModelsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetModelsOutput) String() string
- type GetModelsPaginator
- func NewGetModelsPaginator(req GetModelsRequest) GetModelsPaginator
- func (p *GetModelsPaginator) CurrentPage() *GetModelsOutput
- type GetModelsRequest
- type GetModelsResponse
- type GetRequestValidatorInput
- func (s GetRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRequestValidatorInput) String() string
- func (s *GetRequestValidatorInput) Validate() error
- type GetRequestValidatorOutput
- func (s GetRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRequestValidatorOutput) String() string
- type GetRequestValidatorRequest
- type GetRequestValidatorResponse
- type GetRequestValidatorsInput
- func (s GetRequestValidatorsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRequestValidatorsInput) String() string
- func (s *GetRequestValidatorsInput) Validate() error
- type GetRequestValidatorsOutput
- func (s GetRequestValidatorsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRequestValidatorsOutput) String() string
- type GetRequestValidatorsRequest
- type GetRequestValidatorsResponse
- type GetResourceInput
- func (s GetResourceInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetResourceInput) String() string
- func (s *GetResourceInput) Validate() error
- type GetResourceOutput
- func (s GetResourceOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetResourceOutput) String() string
- type GetResourceRequest
- type GetResourceResponse
- type GetResourcesInput
- func (s GetResourcesInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetResourcesInput) String() string
- func (s *GetResourcesInput) Validate() error
- type GetResourcesOutput
- func (s GetResourcesOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetResourcesOutput) String() string
- type GetResourcesPaginator
- func NewGetResourcesPaginator(req GetResourcesRequest) GetResourcesPaginator
- func (p *GetResourcesPaginator) CurrentPage() *GetResourcesOutput
- type GetResourcesRequest
- type GetResourcesResponse
- type GetRestApiInput
- func (s GetRestApiInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRestApiInput) String() string
- func (s *GetRestApiInput) Validate() error
- type GetRestApiOutput
- func (s GetRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRestApiOutput) String() string
- type GetRestApiRequest
- type GetRestApiResponse
- type GetRestApisInput
- func (s GetRestApisInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRestApisInput) String() string
- type GetRestApisOutput
- func (s GetRestApisOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetRestApisOutput) String() string
- type GetRestApisPaginator
- func NewGetRestApisPaginator(req GetRestApisRequest) GetRestApisPaginator
- func (p *GetRestApisPaginator) CurrentPage() *GetRestApisOutput
- type GetRestApisRequest
- type GetRestApisResponse
- type GetSdkInput
- func (s GetSdkInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetSdkInput) String() string
- func (s *GetSdkInput) Validate() error
- type GetSdkOutput
- func (s GetSdkOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetSdkOutput) String() string
- type GetSdkRequest
- type GetSdkResponse
- type GetSdkTypeInput
- func (s GetSdkTypeInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetSdkTypeInput) String() string
- func (s *GetSdkTypeInput) Validate() error
- type GetSdkTypeOutput
- func (s GetSdkTypeOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetSdkTypeOutput) String() string
- type GetSdkTypeRequest
- type GetSdkTypeResponse
- type GetSdkTypesInput
- func (s GetSdkTypesInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetSdkTypesInput) String() string
- type GetSdkTypesOutput
- func (s GetSdkTypesOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetSdkTypesOutput) String() string
- type GetSdkTypesRequest
- type GetSdkTypesResponse
- type GetStageInput
- func (s GetStageInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetStageInput) String() string
- func (s *GetStageInput) Validate() error
- type GetStageOutput
- func (s GetStageOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetStageOutput) String() string
- type GetStageRequest
- type GetStageResponse
- type GetStagesInput
- func (s GetStagesInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetStagesInput) String() string
- func (s *GetStagesInput) Validate() error
- type GetStagesOutput
- func (s GetStagesOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetStagesOutput) String() string
- type GetStagesRequest
- type GetStagesResponse
- type GetTagsInput
- func (s GetTagsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetTagsInput) String() string
- func (s *GetTagsInput) Validate() error
- type GetTagsOutput
- func (s GetTagsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetTagsOutput) String() string
- type GetTagsRequest
- type GetTagsResponse
- type GetUsageInput
- func (s GetUsageInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsageInput) String() string
- func (s *GetUsageInput) Validate() error
- type GetUsageOutput
- func (s GetUsageOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsageOutput) String() string
- type GetUsagePaginator
- func NewGetUsagePaginator(req GetUsageRequest) GetUsagePaginator
- func (p *GetUsagePaginator) CurrentPage() *GetUsageOutput
- type GetUsagePlanInput
- func (s GetUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlanInput) String() string
- func (s *GetUsagePlanInput) Validate() error
- type GetUsagePlanKeyInput
- func (s GetUsagePlanKeyInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlanKeyInput) String() string
- func (s *GetUsagePlanKeyInput) Validate() error
- type GetUsagePlanKeyOutput
- func (s GetUsagePlanKeyOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlanKeyOutput) String() string
- type GetUsagePlanKeyRequest
- type GetUsagePlanKeyResponse
- type GetUsagePlanKeysInput
- func (s GetUsagePlanKeysInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlanKeysInput) String() string
- func (s *GetUsagePlanKeysInput) Validate() error
- type GetUsagePlanKeysOutput
- func (s GetUsagePlanKeysOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlanKeysOutput) String() string
- type GetUsagePlanKeysPaginator
- func NewGetUsagePlanKeysPaginator(req GetUsagePlanKeysRequest) GetUsagePlanKeysPaginator
- func (p *GetUsagePlanKeysPaginator) CurrentPage() *GetUsagePlanKeysOutput
- type GetUsagePlanKeysRequest
- type GetUsagePlanKeysResponse
- type GetUsagePlanOutput
- func (s GetUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlanOutput) String() string
- type GetUsagePlanRequest
- type GetUsagePlanResponse
- type GetUsagePlansInput
- func (s GetUsagePlansInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlansInput) String() string
- type GetUsagePlansOutput
- func (s GetUsagePlansOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetUsagePlansOutput) String() string
- type GetUsagePlansPaginator
- func NewGetUsagePlansPaginator(req GetUsagePlansRequest) GetUsagePlansPaginator
- func (p *GetUsagePlansPaginator) CurrentPage() *GetUsagePlansOutput
- type GetUsagePlansRequest
- type GetUsagePlansResponse
- type GetUsageRequest
- type GetUsageResponse
- type GetVpcLinkInput
- func (s GetVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetVpcLinkInput) String() string
- func (s *GetVpcLinkInput) Validate() error
- type GetVpcLinkOutput
- func (s GetVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetVpcLinkOutput) String() string
- type GetVpcLinkRequest
- type GetVpcLinkResponse
- type GetVpcLinksInput
- func (s GetVpcLinksInput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetVpcLinksInput) String() string
- type GetVpcLinksOutput
- func (s GetVpcLinksOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s GetVpcLinksOutput) String() string
- type GetVpcLinksPaginator
- func NewGetVpcLinksPaginator(req GetVpcLinksRequest) GetVpcLinksPaginator
- func (p *GetVpcLinksPaginator) CurrentPage() *GetVpcLinksOutput
- type GetVpcLinksRequest
- type GetVpcLinksResponse
- type ImportApiKeysInput
- func (s ImportApiKeysInput) MarshalFields(e protocol.FieldEncoder) error
- func (s ImportApiKeysInput) String() string
- func (s *ImportApiKeysInput) Validate() error
- type ImportApiKeysOutput
- func (s ImportApiKeysOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s ImportApiKeysOutput) String() string
- type ImportApiKeysRequest
- type ImportApiKeysResponse
- type ImportDocumentationPartsInput
- func (s ImportDocumentationPartsInput) MarshalFields(e protocol.FieldEncoder) error
- func (s ImportDocumentationPartsInput) String() string
- func (s *ImportDocumentationPartsInput) Validate() error
- type ImportDocumentationPartsOutput
- func (s ImportDocumentationPartsOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s ImportDocumentationPartsOutput) String() string
- type ImportDocumentationPartsRequest
- type ImportDocumentationPartsResponse
- type ImportRestApiInput
- func (s ImportRestApiInput) MarshalFields(e protocol.FieldEncoder) error
- func (s ImportRestApiInput) String() string
- func (s *ImportRestApiInput) Validate() error
- type ImportRestApiOutput
- func (s ImportRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s ImportRestApiOutput) String() string
- type ImportRestApiRequest
- type ImportRestApiResponse
- type Integration
- func (s Integration) MarshalFields(e protocol.FieldEncoder) error
- func (s Integration) String() string
- type IntegrationResponse
- func (s IntegrationResponse) MarshalFields(e protocol.FieldEncoder) error
- func (s IntegrationResponse) String() string
- type IntegrationType
- func (enum IntegrationType) MarshalValue() (string, error)
- func (enum IntegrationType) MarshalValueBuf(b []byte) ([]byte, error)
- type LocationStatusType
- func (enum LocationStatusType) MarshalValue() (string, error)
- func (enum LocationStatusType) MarshalValueBuf(b []byte) ([]byte, error)
- type Method
- type MethodResponse
- func (s MethodResponse) MarshalFields(e protocol.FieldEncoder) error
- func (s MethodResponse) String() string
- type MethodSetting
- func (s MethodSetting) MarshalFields(e protocol.FieldEncoder) error
- func (s MethodSetting) String() string
- type MethodSnapshot
- func (s MethodSnapshot) MarshalFields(e protocol.FieldEncoder) error
- func (s MethodSnapshot) String() string
- type Model
- type Op
- func (enum Op) MarshalValue() (string, error)
- func (enum Op) MarshalValueBuf(b []byte) ([]byte, error)
- type PatchOperation
- func (s PatchOperation) MarshalFields(e protocol.FieldEncoder) error
- func (s PatchOperation) String() string
- type PutGatewayResponseInput
- func (s PutGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutGatewayResponseInput) String() string
- func (s *PutGatewayResponseInput) Validate() error
- type PutGatewayResponseOutput
- func (s PutGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutGatewayResponseOutput) String() string
- type PutGatewayResponseRequest
- type PutGatewayResponseResponse
- type PutIntegrationInput
- func (s PutIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutIntegrationInput) String() string
- func (s *PutIntegrationInput) Validate() error
- type PutIntegrationOutput
- func (s PutIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutIntegrationOutput) String() string
- type PutIntegrationRequest
- type PutIntegrationResponse
- type PutIntegrationResponseInput
- func (s PutIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutIntegrationResponseInput) String() string
- func (s *PutIntegrationResponseInput) Validate() error
- type PutIntegrationResponseOutput
- func (s PutIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutIntegrationResponseOutput) String() string
- type PutIntegrationResponseRequest
- type PutIntegrationResponseResponse
- type PutMethodInput
- func (s PutMethodInput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutMethodInput) String() string
- func (s *PutMethodInput) Validate() error
- type PutMethodOutput
- func (s PutMethodOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutMethodOutput) String() string
- type PutMethodRequest
- type PutMethodResponse
- type PutMethodResponseInput
- func (s PutMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutMethodResponseInput) String() string
- func (s *PutMethodResponseInput) Validate() error
- type PutMethodResponseOutput
- func (s PutMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutMethodResponseOutput) String() string
- type PutMethodResponseRequest
- type PutMethodResponseResponse
- type PutMode
- func (enum PutMode) MarshalValue() (string, error)
- func (enum PutMode) MarshalValueBuf(b []byte) ([]byte, error)
- type PutRestApiInput
- func (s PutRestApiInput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutRestApiInput) String() string
- func (s *PutRestApiInput) Validate() error
- type PutRestApiOutput
- func (s PutRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s PutRestApiOutput) String() string
- type PutRestApiRequest
- type PutRestApiResponse
- type QuotaPeriodType
- func (enum QuotaPeriodType) MarshalValue() (string, error)
- func (enum QuotaPeriodType) MarshalValueBuf(b []byte) ([]byte, error)
- type QuotaSettings
- func (s QuotaSettings) MarshalFields(e protocol.FieldEncoder) error
- func (s QuotaSettings) String() string
- type RequestValidator
- func (s RequestValidator) MarshalFields(e protocol.FieldEncoder) error
- func (s RequestValidator) String() string
- type Resource
- type RestApi
- type SdkConfigurationProperty
- func (s SdkConfigurationProperty) MarshalFields(e protocol.FieldEncoder) error
- func (s SdkConfigurationProperty) String() string
- type SdkType
- type SecurityPolicy
- func (enum SecurityPolicy) MarshalValue() (string, error)
- func (enum SecurityPolicy) MarshalValueBuf(b []byte) ([]byte, error)
- type Stage
- type StageKey
- type TagResourceInput
- func (s TagResourceInput) MarshalFields(e protocol.FieldEncoder) error
- func (s TagResourceInput) String() string
- func (s *TagResourceInput) Validate() error
- type TagResourceOutput
- func (s TagResourceOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s TagResourceOutput) String() string
- type TagResourceRequest
- type TagResourceResponse
- type TestInvokeAuthorizerInput
- func (s TestInvokeAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
- func (s TestInvokeAuthorizerInput) String() string
- func (s *TestInvokeAuthorizerInput) Validate() error
- type TestInvokeAuthorizerOutput
- func (s TestInvokeAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s TestInvokeAuthorizerOutput) String() string
- type TestInvokeAuthorizerRequest
- type TestInvokeAuthorizerResponse
- type TestInvokeMethodInput
- func (s TestInvokeMethodInput) MarshalFields(e protocol.FieldEncoder) error
- func (s TestInvokeMethodInput) String() string
- func (s *TestInvokeMethodInput) Validate() error
- type TestInvokeMethodOutput
- func (s TestInvokeMethodOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s TestInvokeMethodOutput) String() string
- type TestInvokeMethodRequest
- type TestInvokeMethodResponse
- type ThrottleSettings
- func (s ThrottleSettings) MarshalFields(e protocol.FieldEncoder) error
- func (s ThrottleSettings) String() string
- type UnauthorizedCacheControlHeaderStrategy
- func (enum UnauthorizedCacheControlHeaderStrategy) MarshalValue() (string, error)
- func (enum UnauthorizedCacheControlHeaderStrategy) MarshalValueBuf(b []byte) ([]byte, error)
- type UntagResourceInput
- func (s UntagResourceInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UntagResourceInput) String() string
- func (s *UntagResourceInput) Validate() error
- type UntagResourceOutput
- func (s UntagResourceOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UntagResourceOutput) String() string
- type UntagResourceRequest
- type UntagResourceResponse
- type UpdateAccountInput
- func (s UpdateAccountInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateAccountInput) String() string
- type UpdateAccountOutput
- func (s UpdateAccountOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateAccountOutput) String() string
- type UpdateAccountRequest
- type UpdateAccountResponse
- type UpdateApiKeyInput
- func (s UpdateApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateApiKeyInput) String() string
- func (s *UpdateApiKeyInput) Validate() error
- type UpdateApiKeyOutput
- func (s UpdateApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateApiKeyOutput) String() string
- type UpdateApiKeyRequest
- type UpdateApiKeyResponse
- type UpdateAuthorizerInput
- func (s UpdateAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateAuthorizerInput) String() string
- func (s *UpdateAuthorizerInput) Validate() error
- type UpdateAuthorizerOutput
- func (s UpdateAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateAuthorizerOutput) String() string
- type UpdateAuthorizerRequest
- type UpdateAuthorizerResponse
- type UpdateBasePathMappingInput
- func (s UpdateBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateBasePathMappingInput) String() string
- func (s *UpdateBasePathMappingInput) Validate() error
- type UpdateBasePathMappingOutput
- func (s UpdateBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateBasePathMappingOutput) String() string
- type UpdateBasePathMappingRequest
- type UpdateBasePathMappingResponse
- type UpdateClientCertificateInput
- func (s UpdateClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateClientCertificateInput) String() string
- func (s *UpdateClientCertificateInput) Validate() error
- type UpdateClientCertificateOutput
- func (s UpdateClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateClientCertificateOutput) String() string
- type UpdateClientCertificateRequest
- type UpdateClientCertificateResponse
- type UpdateDeploymentInput
- func (s UpdateDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDeploymentInput) String() string
- func (s *UpdateDeploymentInput) Validate() error
- type UpdateDeploymentOutput
- func (s UpdateDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDeploymentOutput) String() string
- type UpdateDeploymentRequest
- type UpdateDeploymentResponse
- type UpdateDocumentationPartInput
- func (s UpdateDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDocumentationPartInput) String() string
- func (s *UpdateDocumentationPartInput) Validate() error
- type UpdateDocumentationPartOutput
- func (s UpdateDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDocumentationPartOutput) String() string
- type UpdateDocumentationPartRequest
- type UpdateDocumentationPartResponse
- type UpdateDocumentationVersionInput
- func (s UpdateDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDocumentationVersionInput) String() string
- func (s *UpdateDocumentationVersionInput) Validate() error
- type UpdateDocumentationVersionOutput
- func (s UpdateDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDocumentationVersionOutput) String() string
- type UpdateDocumentationVersionRequest
- type UpdateDocumentationVersionResponse
- type UpdateDomainNameInput
- func (s UpdateDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDomainNameInput) String() string
- func (s *UpdateDomainNameInput) Validate() error
- type UpdateDomainNameOutput
- func (s UpdateDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateDomainNameOutput) String() string
- type UpdateDomainNameRequest
- type UpdateDomainNameResponse
- type UpdateGatewayResponseInput
- func (s UpdateGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateGatewayResponseInput) String() string
- func (s *UpdateGatewayResponseInput) Validate() error
- type UpdateGatewayResponseOutput
- func (s UpdateGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateGatewayResponseOutput) String() string
- type UpdateGatewayResponseRequest
- type UpdateGatewayResponseResponse
- type UpdateIntegrationInput
- func (s UpdateIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateIntegrationInput) String() string
- func (s *UpdateIntegrationInput) Validate() error
- type UpdateIntegrationOutput
- func (s UpdateIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateIntegrationOutput) String() string
- type UpdateIntegrationRequest
- type UpdateIntegrationResponse
- type UpdateIntegrationResponseInput
- func (s UpdateIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateIntegrationResponseInput) String() string
- func (s *UpdateIntegrationResponseInput) Validate() error
- type UpdateIntegrationResponseOutput
- func (s UpdateIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateIntegrationResponseOutput) String() string
- type UpdateIntegrationResponseRequest
- type UpdateIntegrationResponseResponse
- type UpdateMethodInput
- func (s UpdateMethodInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateMethodInput) String() string
- func (s *UpdateMethodInput) Validate() error
- type UpdateMethodOutput
- func (s UpdateMethodOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateMethodOutput) String() string
- type UpdateMethodRequest
- type UpdateMethodResponse
- type UpdateMethodResponseInput
- func (s UpdateMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateMethodResponseInput) String() string
- func (s *UpdateMethodResponseInput) Validate() error
- type UpdateMethodResponseOutput
- func (s UpdateMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateMethodResponseOutput) String() string
- type UpdateMethodResponseRequest
- type UpdateMethodResponseResponse
- type UpdateModelInput
- func (s UpdateModelInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateModelInput) String() string
- func (s *UpdateModelInput) Validate() error
- type UpdateModelOutput
- func (s UpdateModelOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateModelOutput) String() string
- type UpdateModelRequest
- type UpdateModelResponse
- type UpdateRequestValidatorInput
- func (s UpdateRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateRequestValidatorInput) String() string
- func (s *UpdateRequestValidatorInput) Validate() error
- type UpdateRequestValidatorOutput
- func (s UpdateRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateRequestValidatorOutput) String() string
- type UpdateRequestValidatorRequest
- type UpdateRequestValidatorResponse
- type UpdateResourceInput
- func (s UpdateResourceInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateResourceInput) String() string
- func (s *UpdateResourceInput) Validate() error
- type UpdateResourceOutput
- func (s UpdateResourceOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateResourceOutput) String() string
- type UpdateResourceRequest
- type UpdateResourceResponse
- type UpdateRestApiInput
- func (s UpdateRestApiInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateRestApiInput) String() string
- func (s *UpdateRestApiInput) Validate() error
- type UpdateRestApiOutput
- func (s UpdateRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateRestApiOutput) String() string
- type UpdateRestApiRequest
- type UpdateRestApiResponse
- type UpdateStageInput
- func (s UpdateStageInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateStageInput) String() string
- func (s *UpdateStageInput) Validate() error
- type UpdateStageOutput
- func (s UpdateStageOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateStageOutput) String() string
- type UpdateStageRequest
- type UpdateStageResponse
- type UpdateUsageInput
- func (s UpdateUsageInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateUsageInput) String() string
- func (s *UpdateUsageInput) Validate() error
- type UpdateUsageOutput
- func (s UpdateUsageOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateUsageOutput) String() string
- type UpdateUsagePlanInput
- func (s UpdateUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateUsagePlanInput) String() string
- func (s *UpdateUsagePlanInput) Validate() error
- type UpdateUsagePlanOutput
- func (s UpdateUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateUsagePlanOutput) String() string
- type UpdateUsagePlanRequest
- type UpdateUsagePlanResponse
- type UpdateUsageRequest
- type UpdateUsageResponse
- type UpdateVpcLinkInput
- func (s UpdateVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateVpcLinkInput) String() string
- func (s *UpdateVpcLinkInput) Validate() error
- type UpdateVpcLinkOutput
- func (s UpdateVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
- func (s UpdateVpcLinkOutput) String() string
- type UpdateVpcLinkRequest
- type UpdateVpcLinkResponse
- type UsagePlan
- type UsagePlanKey
- func (s UsagePlanKey) MarshalFields(e protocol.FieldEncoder) error
- func (s UsagePlanKey) String() string
- type VpcLink
- type VpcLinkStatus
Constants ¶
const ( ServiceName = "Amazon API Gateway" // Service's name ServiceID = "APIGateway" // Service's identifier EndpointsID = "apigateway" // Service's Endpoint identifier )
const ( // ErrCodeBadRequestException for service response error code // "BadRequestException". // // The submitted request is not valid, for example, the input is incomplete // or incorrect. See the accompanying error message for details. ErrCodeBadRequestException = "BadRequestException" // ErrCodeConflictException for service response error code // "ConflictException". // // The request configuration has conflicts. For details, see the accompanying // error message. ErrCodeConflictException = "ConflictException" // ErrCodeLimitExceededException for service response error code // "LimitExceededException". // // The request exceeded the rate limit. Retry after the specified time period. ErrCodeLimitExceededException = "LimitExceededException" // ErrCodeNotFoundException for service response error code // "NotFoundException". // // The requested resource is not found. Make sure that the request URI is correct. ErrCodeNotFoundException = "NotFoundException" // ErrCodeServiceUnavailableException for service response error code // "ServiceUnavailableException". // // The requested service is not available. For details see the accompanying // error message. Retry after the specified time period. = "ServiceUnavailableException" // ErrCodeTooManyRequestsException for service response error code // "TooManyRequestsException". // // The request has reached its throttling limit. Retry after the specified time // period. ErrCodeTooManyRequestsException = "TooManyRequestsException" // ErrCodeUnauthorizedException for service response error code // "UnauthorizedException". // // The request is denied because the caller has insufficient permissions. = "UnauthorizedException" )
Types ¶
type AccessLogSettings ¶
type AccessLogSettings struct { // The ARN of the CloudWatch Logs log group to receive access logs. DestinationArn *string `locationName:"destinationArn" type:"string"` // A single line format of the access logs of data, as specified by selected // $context variables (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#context-variable-reference). // The format must include at least $context.requestId. Format *string `locationName:"format" type:"string"` // contains filtered or unexported fields }
Access log settings, including the access log format and access log destination ARN.
func (AccessLogSettings) MarshalFields ¶
func (s AccessLogSettings) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (AccessLogSettings) String ¶
func (s AccessLogSettings) String() string
String returns the string representation
type ApiKey ¶
type ApiKey struct { // The timestamp when the API Key was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // An AWS Marketplace customer identifier , when integrating with the AWS SaaS // Marketplace. CustomerId *string `locationName:"customerId" type:"string"` // The description of the API Key. Description *string `locationName:"description" type:"string"` // Specifies whether the API Key can be used by callers. Enabled *bool `locationName:"enabled" type:"boolean"` // The identifier of the API Key. Id *string `locationName:"id" type:"string"` // The timestamp when the API Key was last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // The name of the API Key. Name *string `locationName:"name" type:"string"` // A list of Stage resources that are associated with the ApiKey resource. StageKeys []string `locationName:"stageKeys" type:"list"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The value of the API Key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
A resource that can be distributed to callers for executing Method resources that require an API key. API keys can be mapped to any Stage on any RestApi, which indicates that the callers with the API key can make requests to that stage.
Use API Keys (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-api-keys.html)
func (ApiKey) MarshalFields ¶
func (s ApiKey) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ApiKey) String ¶
String returns the string representation
type ApiKeySourceType ¶
type ApiKeySourceType string
const ( ApiKeySourceTypeHeader ApiKeySourceType = "HEADER" ApiKeySourceTypeAuthorizer ApiKeySourceType = "AUTHORIZER" )
Enum values for ApiKeySourceType
func (ApiKeySourceType) MarshalValue ¶
func (enum ApiKeySourceType) MarshalValue() (string, error)
func (ApiKeySourceType) MarshalValueBuf ¶
func (enum ApiKeySourceType) MarshalValueBuf(b []byte) ([]byte, error)
type ApiKeysFormat ¶
type ApiKeysFormat string
const ( ApiKeysFormatCsv ApiKeysFormat = "csv" )
Enum values for ApiKeysFormat
func (ApiKeysFormat) MarshalValue ¶
func (enum ApiKeysFormat) MarshalValue() (string, error)
func (ApiKeysFormat) MarshalValueBuf ¶
func (enum ApiKeysFormat) MarshalValueBuf(b []byte) ([]byte, error)
type ApiStage ¶
type ApiStage struct { // API Id of the associated API stage in a usage plan. ApiId *string `locationName:"apiId" type:"string"` // API stage name of the associated API stage in a usage plan. Stage *string `locationName:"stage" type:"string"` // Map containing method level throttling information for API stage in a usage // plan. Throttle map[string]ThrottleSettings `locationName:"throttle" type:"map"` // contains filtered or unexported fields }
API stage name of the associated API stage in a usage plan.
func (ApiStage) MarshalFields ¶
func (s ApiStage) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ApiStage) String ¶
String returns the string representation
type Authorizer ¶
type Authorizer struct { // Optional customer-defined field, used in OpenAPI imports and exports without // functional impact. AuthType *string `locationName:"authType" type:"string"` // Specifies the required credentials as an IAM role for API Gateway to invoke // the authorizer. To specify an IAM role for API Gateway to assume, use the // role's Amazon Resource Name (ARN). To use resource-based permissions on the // Lambda function, specify null. AuthorizerCredentials *string `locationName:"authorizerCredentials" type:"string"` // The TTL in seconds of cached authorizer results. If it equals 0, authorization // caching is disabled. If it is greater than 0, API Gateway will cache authorizer // responses. If this field is not set, the default value is 300. The maximum // value is 3600, or 1 hour. AuthorizerResultTtlInSeconds *int64 `locationName:"authorizerResultTtlInSeconds" type:"integer"` // Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN or // REQUEST authorizers, this must be a well-formed Lambda function URI, for // example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations. // In general, the URI has this form arn:aws:apigateway:{region}:lambda:path/{service_api}, // where {region} is the same as the region hosting the Lambda function, path // indicates that the remaining substring in the URI should be treated as the // path to the resource, including the initial /. For Lambda functions, this // is usually of the form /2015-03-31/functions/[FunctionARN]/invocations. AuthorizerUri *string `locationName:"authorizerUri" type:"string"` // The identifier for the authorizer resource. Id *string `locationName:"id" type:"string"` // The identity source for which authorization is requested. // * For a TOKEN or COGNITO_USER_POOLS authorizer, this is required and specifies // the request header mapping expression for the custom header holding the // authorization token submitted by the client. For example, if the token // header name is Auth, the header mapping expression is method.request.header.Auth. // // * For the REQUEST authorizer, this is required when authorization caching // is enabled. The value is a comma-separated string of one or more mapping // expressions of the specified request parameters. For example, if an Auth // header, a Name query string parameter are defined as identity sources, // this value is method.request.header.Auth, method.request.querystring.Name. // These parameters will be used to derive the authorization caching key // and to perform runtime validation of the REQUEST authorizer by verifying // all of the identity-related request parameters are present, not null and // non-empty. Only when this is true does the authorizer invoke the authorizer // Lambda function, otherwise, it returns a 401 Unauthorized response without // calling the Lambda function. The valid value is a string of comma-separated // mapping expressions of the specified request parameters. When the authorization // caching is not enabled, this property is optional. IdentitySource *string `locationName:"identitySource" type:"string"` // A validation expression for the incoming identity token. For TOKEN authorizers, // this value is a regular expression. For COGNITO_USER_POOLS authorizers, API // Gateway will match the aud field of the incoming token from the client against // the specified regular expression. It will invoke the authorizer's Lambda // function when there is a match. Otherwise, it will return a 401 Unauthorized // response without calling the Lambda function. The validation expression does // not apply to the REQUEST authorizer. IdentityValidationExpression *string `locationName:"identityValidationExpression" type:"string"` // [Required] The name of the authorizer. Name *string `locationName:"name" type:"string"` // A list of the Amazon Cognito user pool ARNs for the COGNITO_USER_POOLS authorizer. // Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}. // For a TOKEN or REQUEST authorizer, this is not defined. ProviderARNs []string `locationName:"providerARNs" type:"list"` // The authorizer type. Valid values are TOKEN for a Lambda function using a // single authorization token submitted in a custom header, REQUEST for a Lambda // function using incoming request parameters, and COGNITO_USER_POOLS for using // an Amazon Cognito user pool. Type AuthorizerType `locationName:"type" type:"string" enum:"true"` // contains filtered or unexported fields }
Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.
Use Lambda Function as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html) Use Cognito User Pool as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html)
func (Authorizer) MarshalFields ¶
func (s Authorizer) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Authorizer) String ¶
func (s Authorizer) String() string
String returns the string representation
type AuthorizerType ¶
type AuthorizerType string
The authorizer type. Valid values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda function using incoming request parameters, and COGNITO_USER_POOLS for using an Amazon Cognito user pool.
const ( AuthorizerTypeToken AuthorizerType = "TOKEN" AuthorizerTypeRequest AuthorizerType = "REQUEST" AuthorizerTypeCognitoUserPools AuthorizerType = "COGNITO_USER_POOLS" )
Enum values for AuthorizerType
func (AuthorizerType) MarshalValue ¶
func (enum AuthorizerType) MarshalValue() (string, error)
func (AuthorizerType) MarshalValueBuf ¶
func (enum AuthorizerType) MarshalValueBuf(b []byte) ([]byte, error)
type BasePathMapping ¶
type BasePathMapping struct { // The base path name that callers of the API must provide as part of the URL // after the domain name. BasePath *string `locationName:"basePath" type:"string"` // The string identifier of the associated RestApi. RestApiId *string `locationName:"restApiId" type:"string"` // The name of the associated stage. Stage *string `locationName:"stage" type:"string"` // contains filtered or unexported fields }
Represents the base path that callers of the API must provide as part of the URL after the domain name.
A custom domain name plus a BasePathMapping specification identifies a deployed RestApi in a given stage of the owner Account.
Use Custom Domain Names (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (BasePathMapping) MarshalFields ¶
func (s BasePathMapping) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (BasePathMapping) String ¶
func (s BasePathMapping) String() string
String returns the string representation
type CacheClusterSize ¶
type CacheClusterSize string
Returns the size of the CacheCluster.
const ( CacheClusterSize05 CacheClusterSize = "0.5" CacheClusterSize16 CacheClusterSize = "1.6" CacheClusterSize61 CacheClusterSize = "6.1" CacheClusterSize135 CacheClusterSize = "13.5" CacheClusterSize284 CacheClusterSize = "28.4" CacheClusterSize582 CacheClusterSize = "58.2" CacheClusterSize118 CacheClusterSize = "118" CacheClusterSize237 CacheClusterSize = "237" )
Enum values for CacheClusterSize
func (CacheClusterSize) MarshalValue ¶
func (enum CacheClusterSize) MarshalValue() (string, error)
func (CacheClusterSize) MarshalValueBuf ¶
func (enum CacheClusterSize) MarshalValueBuf(b []byte) ([]byte, error)
type CacheClusterStatus ¶
type CacheClusterStatus string
Returns the status of the CacheCluster.
const ( CacheClusterStatusCreateInProgress CacheClusterStatus = "CREATE_IN_PROGRESS" CacheClusterStatusAvailable CacheClusterStatus = "AVAILABLE" CacheClusterStatusDeleteInProgress CacheClusterStatus = "DELETE_IN_PROGRESS" CacheClusterStatusNotAvailable CacheClusterStatus = "NOT_AVAILABLE" CacheClusterStatusFlushInProgress CacheClusterStatus = "FLUSH_IN_PROGRESS" )
Enum values for CacheClusterStatus
func (CacheClusterStatus) MarshalValue ¶
func (enum CacheClusterStatus) MarshalValue() (string, error)
func (CacheClusterStatus) MarshalValueBuf ¶
func (enum CacheClusterStatus) MarshalValueBuf(b []byte) ([]byte, error)
type CanarySettings ¶
type CanarySettings struct { // The ID of the canary deployment. DeploymentId *string `locationName:"deploymentId" type:"string"` // The percent (0-100) of traffic diverted to a canary deployment. PercentTraffic *float64 `locationName:"percentTraffic" type:"double"` // Stage variables overridden for a canary release deployment, including new // stage variables introduced in the canary. These stage variables are represented // as a string-to-string map between stage variable names and their values. StageVariableOverrides map[string]string `locationName:"stageVariableOverrides" type:"map"` // A Boolean flag to indicate whether the canary deployment uses the stage cache // or not. UseStageCache *bool `locationName:"useStageCache" type:"boolean"` // contains filtered or unexported fields }
Configuration settings of a canary deployment.
func (CanarySettings) MarshalFields ¶
func (s CanarySettings) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CanarySettings) String ¶
func (s CanarySettings) String() string
String returns the string representation
type Certificate ¶
type Certificate struct { // The identifier of the client certificate. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the client certificate was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the client certificate. Description *string `locationName:"description" type:"string"` // The timestamp when the client certificate will expire. ExpirationDate *time.Time `locationName:"expirationDate" type:"timestamp"` // The PEM-encoded public key of the client certificate, which can be used to // configure certificate authentication in the integration endpoint . PemEncodedCertificate *string `locationName:"pemEncodedCertificate" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a client certificate used to configure client-side SSL authentication while sending requests to the integration endpoint.
Client certificates are used to authenticate an API by the backend server. To authenticate an API client (or user), use IAM roles and policies, a custom Authorizer or an Amazon Cognito user pool.
Use Client-Side Certificate (https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
func (Certificate) MarshalFields ¶
func (s Certificate) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Certificate) String ¶
func (s Certificate) String() string
String returns the string representation
type Client ¶
Client provides the API operation methods for making requests to Amazon API Gateway. See this package's package overview docs for details on the service.
The client's methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.
func New ¶
New creates a new instance of the client from the provided Config.
Example:
// Create a client from just a config. svc := apigateway.New(myConfig)
func (*Client) CreateApiKeyRequest ¶
func (c *Client) CreateApiKeyRequest(input *CreateApiKeyInput) CreateApiKeyRequest
CreateApiKeyRequest returns a request value for making API operation for Amazon API Gateway.
Create an ApiKey resource.
AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-api-key.html)
// Example sending a request using CreateApiKeyRequest. req := client.CreateApiKeyRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateAuthorizerRequest ¶
func (c *Client) CreateAuthorizerRequest(input *CreateAuthorizerInput) CreateAuthorizerRequest
CreateAuthorizerRequest returns a request value for making API operation for Amazon API Gateway.
Adds a new Authorizer resource to an existing RestApi resource.
AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-authorizer.html)
// Example sending a request using CreateAuthorizerRequest. req := client.CreateAuthorizerRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateBasePathMappingRequest ¶
func (c *Client) CreateBasePathMappingRequest(input *CreateBasePathMappingInput) CreateBasePathMappingRequest
CreateBasePathMappingRequest returns a request value for making API operation for Amazon API Gateway.
Creates a new BasePathMapping resource.
// Example sending a request using CreateBasePathMappingRequest. req := client.CreateBasePathMappingRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateDeploymentRequest ¶
func (c *Client) CreateDeploymentRequest(input *CreateDeploymentInput) CreateDeploymentRequest
CreateDeploymentRequest returns a request value for making API operation for Amazon API Gateway.
Creates a Deployment resource, which makes a specified RestApi callable over the internet.
// Example sending a request using CreateDeploymentRequest. req := client.CreateDeploymentRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateDocumentationPartRequest ¶
func (c *Client) CreateDocumentationPartRequest(input *CreateDocumentationPartInput) CreateDocumentationPartRequest
CreateDocumentationPartRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using CreateDocumentationPartRequest. req := client.CreateDocumentationPartRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateDocumentationVersionRequest ¶
func (c *Client) CreateDocumentationVersionRequest(input *CreateDocumentationVersionInput) CreateDocumentationVersionRequest
CreateDocumentationVersionRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using CreateDocumentationVersionRequest. req := client.CreateDocumentationVersionRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateDomainNameRequest ¶
func (c *Client) CreateDomainNameRequest(input *CreateDomainNameInput) CreateDomainNameRequest
CreateDomainNameRequest returns a request value for making API operation for Amazon API Gateway.
Creates a new domain name.
// Example sending a request using CreateDomainNameRequest. req := client.CreateDomainNameRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateModelRequest ¶
func (c *Client) CreateModelRequest(input *CreateModelInput) CreateModelRequest
CreateModelRequest returns a request value for making API operation for Amazon API Gateway.
Adds a new Model resource to an existing RestApi resource.
// Example sending a request using CreateModelRequest. req := client.CreateModelRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateRequestValidatorRequest ¶
func (c *Client) CreateRequestValidatorRequest(input *CreateRequestValidatorInput) CreateRequestValidatorRequest
CreateRequestValidatorRequest returns a request value for making API operation for Amazon API Gateway.
Creates a ReqeustValidator of a given RestApi.
// Example sending a request using CreateRequestValidatorRequest. req := client.CreateRequestValidatorRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateResourceRequest ¶
func (c *Client) CreateResourceRequest(input *CreateResourceInput) CreateResourceRequest
CreateResourceRequest returns a request value for making API operation for Amazon API Gateway.
Creates a Resource resource.
// Example sending a request using CreateResourceRequest. req := client.CreateResourceRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateRestApiRequest ¶
func (c *Client) CreateRestApiRequest(input *CreateRestApiInput) CreateRestApiRequest
CreateRestApiRequest returns a request value for making API operation for Amazon API Gateway.
Creates a new RestApi resource.
// Example sending a request using CreateRestApiRequest. req := client.CreateRestApiRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateStageRequest ¶
func (c *Client) CreateStageRequest(input *CreateStageInput) CreateStageRequest
CreateStageRequest returns a request value for making API operation for Amazon API Gateway.
Creates a new Stage resource that references a pre-existing Deployment for the API.
// Example sending a request using CreateStageRequest. req := client.CreateStageRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateUsagePlanKeyRequest ¶
func (c *Client) CreateUsagePlanKeyRequest(input *CreateUsagePlanKeyInput) CreateUsagePlanKeyRequest
CreateUsagePlanKeyRequest returns a request value for making API operation for Amazon API Gateway.
Creates a usage plan key for adding an existing API key to a usage plan.
// Example sending a request using CreateUsagePlanKeyRequest. req := client.CreateUsagePlanKeyRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateUsagePlanRequest ¶
func (c *Client) CreateUsagePlanRequest(input *CreateUsagePlanInput) CreateUsagePlanRequest
CreateUsagePlanRequest returns a request value for making API operation for Amazon API Gateway.
Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.
// Example sending a request using CreateUsagePlanRequest. req := client.CreateUsagePlanRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) CreateVpcLinkRequest ¶
func (c *Client) CreateVpcLinkRequest(input *CreateVpcLinkInput) CreateVpcLinkRequest
CreateVpcLinkRequest returns a request value for making API operation for Amazon API Gateway.
Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.
// Example sending a request using CreateVpcLinkRequest. req := client.CreateVpcLinkRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteApiKeyRequest ¶
func (c *Client) DeleteApiKeyRequest(input *DeleteApiKeyInput) DeleteApiKeyRequest
DeleteApiKeyRequest returns a request value for making API operation for Amazon API Gateway.
Deletes the ApiKey resource.
// Example sending a request using DeleteApiKeyRequest. req := client.DeleteApiKeyRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteAuthorizerRequest ¶
func (c *Client) DeleteAuthorizerRequest(input *DeleteAuthorizerInput) DeleteAuthorizerRequest
DeleteAuthorizerRequest returns a request value for making API operation for Amazon API Gateway.
Deletes an existing Authorizer resource.
AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/delete-authorizer.html)
// Example sending a request using DeleteAuthorizerRequest. req := client.DeleteAuthorizerRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteBasePathMappingRequest ¶
func (c *Client) DeleteBasePathMappingRequest(input *DeleteBasePathMappingInput) DeleteBasePathMappingRequest
DeleteBasePathMappingRequest returns a request value for making API operation for Amazon API Gateway.
Deletes the BasePathMapping resource.
// Example sending a request using DeleteBasePathMappingRequest. req := client.DeleteBasePathMappingRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteClientCertificateRequest ¶
func (c *Client) DeleteClientCertificateRequest(input *DeleteClientCertificateInput) DeleteClientCertificateRequest
DeleteClientCertificateRequest returns a request value for making API operation for Amazon API Gateway.
Deletes the ClientCertificate resource.
// Example sending a request using DeleteClientCertificateRequest. req := client.DeleteClientCertificateRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteDeploymentRequest ¶
func (c *Client) DeleteDeploymentRequest(input *DeleteDeploymentInput) DeleteDeploymentRequest
DeleteDeploymentRequest returns a request value for making API operation for Amazon API Gateway.
Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.
// Example sending a request using DeleteDeploymentRequest. req := client.DeleteDeploymentRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteDocumentationPartRequest ¶
func (c *Client) DeleteDocumentationPartRequest(input *DeleteDocumentationPartInput) DeleteDocumentationPartRequest
DeleteDocumentationPartRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using DeleteDocumentationPartRequest. req := client.DeleteDocumentationPartRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteDocumentationVersionRequest ¶
func (c *Client) DeleteDocumentationVersionRequest(input *DeleteDocumentationVersionInput) DeleteDocumentationVersionRequest
DeleteDocumentationVersionRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using DeleteDocumentationVersionRequest. req := client.DeleteDocumentationVersionRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteDomainNameRequest ¶
func (c *Client) DeleteDomainNameRequest(input *DeleteDomainNameInput) DeleteDomainNameRequest
DeleteDomainNameRequest returns a request value for making API operation for Amazon API Gateway.
Deletes the DomainName resource.
// Example sending a request using DeleteDomainNameRequest. req := client.DeleteDomainNameRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteGatewayResponseRequest ¶
func (c *Client) DeleteGatewayResponseRequest(input *DeleteGatewayResponseInput) DeleteGatewayResponseRequest
DeleteGatewayResponseRequest returns a request value for making API operation for Amazon API Gateway.
Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.
// Example sending a request using DeleteGatewayResponseRequest. req := client.DeleteGatewayResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteIntegrationRequest ¶
func (c *Client) DeleteIntegrationRequest(input *DeleteIntegrationInput) DeleteIntegrationRequest
DeleteIntegrationRequest returns a request value for making API operation for Amazon API Gateway.
Represents a delete integration.
// Example sending a request using DeleteIntegrationRequest. req := client.DeleteIntegrationRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteIntegrationResponseRequest ¶
func (c *Client) DeleteIntegrationResponseRequest(input *DeleteIntegrationResponseInput) DeleteIntegrationResponseRequest
DeleteIntegrationResponseRequest returns a request value for making API operation for Amazon API Gateway.
Represents a delete integration response.
// Example sending a request using DeleteIntegrationResponseRequest. req := client.DeleteIntegrationResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteMethodRequest ¶
func (c *Client) DeleteMethodRequest(input *DeleteMethodInput) DeleteMethodRequest
DeleteMethodRequest returns a request value for making API operation for Amazon API Gateway.
Deletes an existing Method resource.
// Example sending a request using DeleteMethodRequest. req := client.DeleteMethodRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteMethodResponseRequest ¶
func (c *Client) DeleteMethodResponseRequest(input *DeleteMethodResponseInput) DeleteMethodResponseRequest
DeleteMethodResponseRequest returns a request value for making API operation for Amazon API Gateway.
Deletes an existing MethodResponse resource.
// Example sending a request using DeleteMethodResponseRequest. req := client.DeleteMethodResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteModelRequest ¶
func (c *Client) DeleteModelRequest(input *DeleteModelInput) DeleteModelRequest
DeleteModelRequest returns a request value for making API operation for Amazon API Gateway.
Deletes a model.
// Example sending a request using DeleteModelRequest. req := client.DeleteModelRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteRequestValidatorRequest ¶
func (c *Client) DeleteRequestValidatorRequest(input *DeleteRequestValidatorInput) DeleteRequestValidatorRequest
DeleteRequestValidatorRequest returns a request value for making API operation for Amazon API Gateway.
Deletes a RequestValidator of a given RestApi.
// Example sending a request using DeleteRequestValidatorRequest. req := client.DeleteRequestValidatorRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteResourceRequest ¶
func (c *Client) DeleteResourceRequest(input *DeleteResourceInput) DeleteResourceRequest
DeleteResourceRequest returns a request value for making API operation for Amazon API Gateway.
Deletes a Resource resource.
// Example sending a request using DeleteResourceRequest. req := client.DeleteResourceRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteRestApiRequest ¶
func (c *Client) DeleteRestApiRequest(input *DeleteRestApiInput) DeleteRestApiRequest
DeleteRestApiRequest returns a request value for making API operation for Amazon API Gateway.
Deletes the specified API.
// Example sending a request using DeleteRestApiRequest. req := client.DeleteRestApiRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteStageRequest ¶
func (c *Client) DeleteStageRequest(input *DeleteStageInput) DeleteStageRequest
DeleteStageRequest returns a request value for making API operation for Amazon API Gateway.
Deletes a Stage resource.
// Example sending a request using DeleteStageRequest. req := client.DeleteStageRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteUsagePlanKeyRequest ¶
func (c *Client) DeleteUsagePlanKeyRequest(input *DeleteUsagePlanKeyInput) DeleteUsagePlanKeyRequest
DeleteUsagePlanKeyRequest returns a request value for making API operation for Amazon API Gateway.
Deletes a usage plan key and remove the underlying API key from the associated usage plan.
// Example sending a request using DeleteUsagePlanKeyRequest. req := client.DeleteUsagePlanKeyRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteUsagePlanRequest ¶
func (c *Client) DeleteUsagePlanRequest(input *DeleteUsagePlanInput) DeleteUsagePlanRequest
DeleteUsagePlanRequest returns a request value for making API operation for Amazon API Gateway.
Deletes a usage plan of a given plan Id.
// Example sending a request using DeleteUsagePlanRequest. req := client.DeleteUsagePlanRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) DeleteVpcLinkRequest ¶
func (c *Client) DeleteVpcLinkRequest(input *DeleteVpcLinkInput) DeleteVpcLinkRequest
DeleteVpcLinkRequest returns a request value for making API operation for Amazon API Gateway.
Deletes an existing VpcLink of a specified identifier.
// Example sending a request using DeleteVpcLinkRequest. req := client.DeleteVpcLinkRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) FlushStageAuthorizersCacheRequest ¶
func (c *Client) FlushStageAuthorizersCacheRequest(input *FlushStageAuthorizersCacheInput) FlushStageAuthorizersCacheRequest
FlushStageAuthorizersCacheRequest returns a request value for making API operation for Amazon API Gateway.
Flushes all authorizer cache entries on a stage.
// Example sending a request using FlushStageAuthorizersCacheRequest. req := client.FlushStageAuthorizersCacheRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) FlushStageCacheRequest ¶
func (c *Client) FlushStageCacheRequest(input *FlushStageCacheInput) FlushStageCacheRequest
FlushStageCacheRequest returns a request value for making API operation for Amazon API Gateway.
Flushes a stage's cache.
// Example sending a request using FlushStageCacheRequest. req := client.FlushStageCacheRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GenerateClientCertificateRequest ¶
func (c *Client) GenerateClientCertificateRequest(input *GenerateClientCertificateInput) GenerateClientCertificateRequest
GenerateClientCertificateRequest returns a request value for making API operation for Amazon API Gateway.
Generates a ClientCertificate resource.
// Example sending a request using GenerateClientCertificateRequest. req := client.GenerateClientCertificateRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetAccountRequest ¶
func (c *Client) GetAccountRequest(input *GetAccountInput) GetAccountRequest
GetAccountRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about the current Account resource.
// Example sending a request using GetAccountRequest. req := client.GetAccountRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetApiKeyRequest ¶
func (c *Client) GetApiKeyRequest(input *GetApiKeyInput) GetApiKeyRequest
GetApiKeyRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about the current ApiKey resource.
// Example sending a request using GetApiKeyRequest. req := client.GetApiKeyRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetApiKeysRequest ¶
func (c *Client) GetApiKeysRequest(input *GetApiKeysInput) GetApiKeysRequest
GetApiKeysRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about the current ApiKeys resource.
// Example sending a request using GetApiKeysRequest. req := client.GetApiKeysRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetAuthorizerRequest ¶
func (c *Client) GetAuthorizerRequest(input *GetAuthorizerInput) GetAuthorizerRequest
GetAuthorizerRequest returns a request value for making API operation for Amazon API Gateway.
Describe an existing Authorizer resource.
AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-authorizer.html)
// Example sending a request using GetAuthorizerRequest. req := client.GetAuthorizerRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetAuthorizersRequest ¶
func (c *Client) GetAuthorizersRequest(input *GetAuthorizersInput) GetAuthorizersRequest
GetAuthorizersRequest returns a request value for making API operation for Amazon API Gateway.
Describe an existing Authorizers resource.
AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-authorizers.html)
// Example sending a request using GetAuthorizersRequest. req := client.GetAuthorizersRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetBasePathMappingRequest ¶
func (c *Client) GetBasePathMappingRequest(input *GetBasePathMappingInput) GetBasePathMappingRequest
GetBasePathMappingRequest returns a request value for making API operation for Amazon API Gateway.
Describe a BasePathMapping resource.
// Example sending a request using GetBasePathMappingRequest. req := client.GetBasePathMappingRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetBasePathMappingsRequest ¶
func (c *Client) GetBasePathMappingsRequest(input *GetBasePathMappingsInput) GetBasePathMappingsRequest
GetBasePathMappingsRequest returns a request value for making API operation for Amazon API Gateway.
Represents a collection of BasePathMapping resources.
// Example sending a request using GetBasePathMappingsRequest. req := client.GetBasePathMappingsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetClientCertificateRequest ¶
func (c *Client) GetClientCertificateRequest(input *GetClientCertificateInput) GetClientCertificateRequest
GetClientCertificateRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about the current ClientCertificate resource.
// Example sending a request using GetClientCertificateRequest. req := client.GetClientCertificateRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetClientCertificatesRequest ¶
func (c *Client) GetClientCertificatesRequest(input *GetClientCertificatesInput) GetClientCertificatesRequest
GetClientCertificatesRequest returns a request value for making API operation for Amazon API Gateway.
Gets a collection of ClientCertificate resources.
// Example sending a request using GetClientCertificatesRequest. req := client.GetClientCertificatesRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDeploymentRequest ¶
func (c *Client) GetDeploymentRequest(input *GetDeploymentInput) GetDeploymentRequest
GetDeploymentRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about a Deployment resource.
// Example sending a request using GetDeploymentRequest. req := client.GetDeploymentRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDeploymentsRequest ¶
func (c *Client) GetDeploymentsRequest(input *GetDeploymentsInput) GetDeploymentsRequest
GetDeploymentsRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about a Deployments collection.
// Example sending a request using GetDeploymentsRequest. req := client.GetDeploymentsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDocumentationPartRequest ¶
func (c *Client) GetDocumentationPartRequest(input *GetDocumentationPartInput) GetDocumentationPartRequest
GetDocumentationPartRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using GetDocumentationPartRequest. req := client.GetDocumentationPartRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDocumentationPartsRequest ¶
func (c *Client) GetDocumentationPartsRequest(input *GetDocumentationPartsInput) GetDocumentationPartsRequest
GetDocumentationPartsRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using GetDocumentationPartsRequest. req := client.GetDocumentationPartsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDocumentationVersionRequest ¶
func (c *Client) GetDocumentationVersionRequest(input *GetDocumentationVersionInput) GetDocumentationVersionRequest
GetDocumentationVersionRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using GetDocumentationVersionRequest. req := client.GetDocumentationVersionRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDocumentationVersionsRequest ¶
func (c *Client) GetDocumentationVersionsRequest(input *GetDocumentationVersionsInput) GetDocumentationVersionsRequest
GetDocumentationVersionsRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using GetDocumentationVersionsRequest. req := client.GetDocumentationVersionsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDomainNameRequest ¶
func (c *Client) GetDomainNameRequest(input *GetDomainNameInput) GetDomainNameRequest
GetDomainNameRequest returns a request value for making API operation for Amazon API Gateway.
Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
// Example sending a request using GetDomainNameRequest. req := client.GetDomainNameRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetDomainNamesRequest ¶
func (c *Client) GetDomainNamesRequest(input *GetDomainNamesInput) GetDomainNamesRequest
GetDomainNamesRequest returns a request value for making API operation for Amazon API Gateway.
Represents a collection of DomainName resources.
// Example sending a request using GetDomainNamesRequest. req := client.GetDomainNamesRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetExportRequest ¶
func (c *Client) GetExportRequest(input *GetExportInput) GetExportRequest
GetExportRequest returns a request value for making API operation for Amazon API Gateway.
Exports a deployed version of a RestApi in a specified format.
// Example sending a request using GetExportRequest. req := client.GetExportRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetGatewayResponseRequest ¶
func (c *Client) GetGatewayResponseRequest(input *GetGatewayResponseInput) GetGatewayResponseRequest
GetGatewayResponseRequest returns a request value for making API operation for Amazon API Gateway.
Gets a GatewayResponse of a specified response type on the given RestApi.
// Example sending a request using GetGatewayResponseRequest. req := client.GetGatewayResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetGatewayResponsesRequest ¶
func (c *Client) GetGatewayResponsesRequest(input *GetGatewayResponsesInput) GetGatewayResponsesRequest
GetGatewayResponsesRequest returns a request value for making API operation for Amazon API Gateway.
Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.
// Example sending a request using GetGatewayResponsesRequest. req := client.GetGatewayResponsesRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetIntegrationRequest ¶
func (c *Client) GetIntegrationRequest(input *GetIntegrationInput) GetIntegrationRequest
GetIntegrationRequest returns a request value for making API operation for Amazon API Gateway.
Get the integration settings.
// Example sending a request using GetIntegrationRequest. req := client.GetIntegrationRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetIntegrationResponseRequest ¶
func (c *Client) GetIntegrationResponseRequest(input *GetIntegrationResponseInput) GetIntegrationResponseRequest
GetIntegrationResponseRequest returns a request value for making API operation for Amazon API Gateway.
Represents a get integration response.
// Example sending a request using GetIntegrationResponseRequest. req := client.GetIntegrationResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetMethodRequest ¶
func (c *Client) GetMethodRequest(input *GetMethodInput) GetMethodRequest
GetMethodRequest returns a request value for making API operation for Amazon API Gateway.
Describe an existing Method resource.
// Example sending a request using GetMethodRequest. req := client.GetMethodRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetMethodResponseRequest ¶
func (c *Client) GetMethodResponseRequest(input *GetMethodResponseInput) GetMethodResponseRequest
GetMethodResponseRequest returns a request value for making API operation for Amazon API Gateway.
Describes a MethodResponse resource.
// Example sending a request using GetMethodResponseRequest. req := client.GetMethodResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetModelRequest ¶
func (c *Client) GetModelRequest(input *GetModelInput) GetModelRequest
GetModelRequest returns a request value for making API operation for Amazon API Gateway.
Describes an existing model defined for a RestApi resource.
// Example sending a request using GetModelRequest. req := client.GetModelRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetModelTemplateRequest ¶
func (c *Client) GetModelTemplateRequest(input *GetModelTemplateInput) GetModelTemplateRequest
GetModelTemplateRequest returns a request value for making API operation for Amazon API Gateway.
Generates a sample mapping template that can be used to transform a payload into the structure of a model.
// Example sending a request using GetModelTemplateRequest. req := client.GetModelTemplateRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetModelsRequest ¶
func (c *Client) GetModelsRequest(input *GetModelsInput) GetModelsRequest
GetModelsRequest returns a request value for making API operation for Amazon API Gateway.
Describes existing Models defined for a RestApi resource.
// Example sending a request using GetModelsRequest. req := client.GetModelsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetRequestValidatorRequest ¶
func (c *Client) GetRequestValidatorRequest(input *GetRequestValidatorInput) GetRequestValidatorRequest
GetRequestValidatorRequest returns a request value for making API operation for Amazon API Gateway.
Gets a RequestValidator of a given RestApi.
// Example sending a request using GetRequestValidatorRequest. req := client.GetRequestValidatorRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetRequestValidatorsRequest ¶
func (c *Client) GetRequestValidatorsRequest(input *GetRequestValidatorsInput) GetRequestValidatorsRequest
GetRequestValidatorsRequest returns a request value for making API operation for Amazon API Gateway.
Gets the RequestValidators collection of a given RestApi.
// Example sending a request using GetRequestValidatorsRequest. req := client.GetRequestValidatorsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetResourceRequest ¶
func (c *Client) GetResourceRequest(input *GetResourceInput) GetResourceRequest
GetResourceRequest returns a request value for making API operation for Amazon API Gateway.
Lists information about a resource.
// Example sending a request using GetResourceRequest. req := client.GetResourceRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetResourcesRequest ¶
func (c *Client) GetResourcesRequest(input *GetResourcesInput) GetResourcesRequest
GetResourcesRequest returns a request value for making API operation for Amazon API Gateway.
Lists information about a collection of Resource resources.
// Example sending a request using GetResourcesRequest. req := client.GetResourcesRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetRestApiRequest ¶
func (c *Client) GetRestApiRequest(input *GetRestApiInput) GetRestApiRequest
GetRestApiRequest returns a request value for making API operation for Amazon API Gateway.
Lists the RestApi resource in the collection.
// Example sending a request using GetRestApiRequest. req := client.GetRestApiRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetRestApisRequest ¶
func (c *Client) GetRestApisRequest(input *GetRestApisInput) GetRestApisRequest
GetRestApisRequest returns a request value for making API operation for Amazon API Gateway.
Lists the RestApis resources for your collection.
// Example sending a request using GetRestApisRequest. req := client.GetRestApisRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetSdkRequest ¶
func (c *Client) GetSdkRequest(input *GetSdkInput) GetSdkRequest
GetSdkRequest returns a request value for making API operation for Amazon API Gateway.
Generates a client SDK for a RestApi and Stage.
// Example sending a request using GetSdkRequest. req := client.GetSdkRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetSdkTypeRequest ¶
func (c *Client) GetSdkTypeRequest(input *GetSdkTypeInput) GetSdkTypeRequest
GetSdkTypeRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using GetSdkTypeRequest. req := client.GetSdkTypeRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetSdkTypesRequest ¶
func (c *Client) GetSdkTypesRequest(input *GetSdkTypesInput) GetSdkTypesRequest
GetSdkTypesRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using GetSdkTypesRequest. req := client.GetSdkTypesRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetStageRequest ¶
func (c *Client) GetStageRequest(input *GetStageInput) GetStageRequest
GetStageRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about a Stage resource.
// Example sending a request using GetStageRequest. req := client.GetStageRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetStagesRequest ¶
func (c *Client) GetStagesRequest(input *GetStagesInput) GetStagesRequest
GetStagesRequest returns a request value for making API operation for Amazon API Gateway.
Gets information about one or more Stage resources.
// Example sending a request using GetStagesRequest. req := client.GetStagesRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetTagsRequest ¶
func (c *Client) GetTagsRequest(input *GetTagsInput) GetTagsRequest
GetTagsRequest returns a request value for making API operation for Amazon API Gateway.
Gets the Tags collection for a given resource.
// Example sending a request using GetTagsRequest. req := client.GetTagsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetUsagePlanKeyRequest ¶
func (c *Client) GetUsagePlanKeyRequest(input *GetUsagePlanKeyInput) GetUsagePlanKeyRequest
GetUsagePlanKeyRequest returns a request value for making API operation for Amazon API Gateway.
Gets a usage plan key of a given key identifier.
// Example sending a request using GetUsagePlanKeyRequest. req := client.GetUsagePlanKeyRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetUsagePlanKeysRequest ¶
func (c *Client) GetUsagePlanKeysRequest(input *GetUsagePlanKeysInput) GetUsagePlanKeysRequest
GetUsagePlanKeysRequest returns a request value for making API operation for Amazon API Gateway.
Gets all the usage plan keys representing the API keys added to a specified usage plan.
// Example sending a request using GetUsagePlanKeysRequest. req := client.GetUsagePlanKeysRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetUsagePlanRequest ¶
func (c *Client) GetUsagePlanRequest(input *GetUsagePlanInput) GetUsagePlanRequest
GetUsagePlanRequest returns a request value for making API operation for Amazon API Gateway.
Gets a usage plan of a given plan identifier.
// Example sending a request using GetUsagePlanRequest. req := client.GetUsagePlanRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetUsagePlansRequest ¶
func (c *Client) GetUsagePlansRequest(input *GetUsagePlansInput) GetUsagePlansRequest
GetUsagePlansRequest returns a request value for making API operation for Amazon API Gateway.
Gets all the usage plans of the caller's account.
// Example sending a request using GetUsagePlansRequest. req := client.GetUsagePlansRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetUsageRequest ¶
func (c *Client) GetUsageRequest(input *GetUsageInput) GetUsageRequest
GetUsageRequest returns a request value for making API operation for Amazon API Gateway.
Gets the usage data of a usage plan in a specified time interval.
// Example sending a request using GetUsageRequest. req := client.GetUsageRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetVpcLinkRequest ¶
func (c *Client) GetVpcLinkRequest(input *GetVpcLinkInput) GetVpcLinkRequest
GetVpcLinkRequest returns a request value for making API operation for Amazon API Gateway.
Gets a specified VPC link under the caller's account in a region.
// Example sending a request using GetVpcLinkRequest. req := client.GetVpcLinkRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) GetVpcLinksRequest ¶
func (c *Client) GetVpcLinksRequest(input *GetVpcLinksInput) GetVpcLinksRequest
GetVpcLinksRequest returns a request value for making API operation for Amazon API Gateway.
Gets the VpcLinks collection under the caller's account in a selected region.
// Example sending a request using GetVpcLinksRequest. req := client.GetVpcLinksRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) ImportApiKeysRequest ¶
func (c *Client) ImportApiKeysRequest(input *ImportApiKeysInput) ImportApiKeysRequest
ImportApiKeysRequest returns a request value for making API operation for Amazon API Gateway.
Import API keys from an external source, such as a CSV-formatted file.
// Example sending a request using ImportApiKeysRequest. req := client.ImportApiKeysRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) ImportDocumentationPartsRequest ¶
func (c *Client) ImportDocumentationPartsRequest(input *ImportDocumentationPartsInput) ImportDocumentationPartsRequest
ImportDocumentationPartsRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using ImportDocumentationPartsRequest. req := client.ImportDocumentationPartsRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) ImportRestApiRequest ¶
func (c *Client) ImportRestApiRequest(input *ImportRestApiInput) ImportRestApiRequest
ImportRestApiRequest returns a request value for making API operation for Amazon API Gateway.
A feature of the API Gateway control service for creating a new API from an external API definition file.
// Example sending a request using ImportRestApiRequest. req := client.ImportRestApiRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) PutGatewayResponseRequest ¶
func (c *Client) PutGatewayResponseRequest(input *PutGatewayResponseInput) PutGatewayResponseRequest
PutGatewayResponseRequest returns a request value for making API operation for Amazon API Gateway.
Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.
// Example sending a request using PutGatewayResponseRequest. req := client.PutGatewayResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) PutIntegrationRequest ¶
func (c *Client) PutIntegrationRequest(input *PutIntegrationInput) PutIntegrationRequest
PutIntegrationRequest returns a request value for making API operation for Amazon API Gateway.
Sets up a method's integration.
// Example sending a request using PutIntegrationRequest. req := client.PutIntegrationRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) PutIntegrationResponseRequest ¶
func (c *Client) PutIntegrationResponseRequest(input *PutIntegrationResponseInput) PutIntegrationResponseRequest
PutIntegrationResponseRequest returns a request value for making API operation for Amazon API Gateway.
Represents a put integration.
// Example sending a request using PutIntegrationResponseRequest. req := client.PutIntegrationResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) PutMethodRequest ¶
func (c *Client) PutMethodRequest(input *PutMethodInput) PutMethodRequest
PutMethodRequest returns a request value for making API operation for Amazon API Gateway.
Add a method to an existing Resource resource.
// Example sending a request using PutMethodRequest. req := client.PutMethodRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) PutMethodResponseRequest ¶
func (c *Client) PutMethodResponseRequest(input *PutMethodResponseInput) PutMethodResponseRequest
PutMethodResponseRequest returns a request value for making API operation for Amazon API Gateway.
Adds a MethodResponse to an existing Method resource.
// Example sending a request using PutMethodResponseRequest. req := client.PutMethodResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) PutRestApiRequest ¶
func (c *Client) PutRestApiRequest(input *PutRestApiInput) PutRestApiRequest
PutRestApiRequest returns a request value for making API operation for Amazon API Gateway.
A feature of the API Gateway control service for updating an existing API with an input of external API definitions. The update can take the form of merging the supplied definition into the existing API or overwriting the existing API.
// Example sending a request using PutRestApiRequest. req := client.PutRestApiRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) TagResourceRequest ¶
func (c *Client) TagResourceRequest(input *TagResourceInput) TagResourceRequest
TagResourceRequest returns a request value for making API operation for Amazon API Gateway.
Adds or updates a tag on a given resource.
// Example sending a request using TagResourceRequest. req := client.TagResourceRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) TestInvokeAuthorizerRequest ¶
func (c *Client) TestInvokeAuthorizerRequest(input *TestInvokeAuthorizerInput) TestInvokeAuthorizerRequest
TestInvokeAuthorizerRequest returns a request value for making API operation for Amazon API Gateway.
Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.
Use Lambda Function as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html) Use Cognito User Pool as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html)
// Example sending a request using TestInvokeAuthorizerRequest. req := client.TestInvokeAuthorizerRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) TestInvokeMethodRequest ¶
func (c *Client) TestInvokeMethodRequest(input *TestInvokeMethodInput) TestInvokeMethodRequest
TestInvokeMethodRequest returns a request value for making API operation for Amazon API Gateway.
Simulate the execution of a Method in your RestApi with headers, parameters, and an incoming request body.
// Example sending a request using TestInvokeMethodRequest. req := client.TestInvokeMethodRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UntagResourceRequest ¶
func (c *Client) UntagResourceRequest(input *UntagResourceInput) UntagResourceRequest
UntagResourceRequest returns a request value for making API operation for Amazon API Gateway.
Removes a tag from a given resource.
// Example sending a request using UntagResourceRequest. req := client.UntagResourceRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateAccountRequest ¶
func (c *Client) UpdateAccountRequest(input *UpdateAccountInput) UpdateAccountRequest
UpdateAccountRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about the current Account resource.
// Example sending a request using UpdateAccountRequest. req := client.UpdateAccountRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateApiKeyRequest ¶
func (c *Client) UpdateApiKeyRequest(input *UpdateApiKeyInput) UpdateApiKeyRequest
UpdateApiKeyRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about an ApiKey resource.
// Example sending a request using UpdateApiKeyRequest. req := client.UpdateApiKeyRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateAuthorizerRequest ¶
func (c *Client) UpdateAuthorizerRequest(input *UpdateAuthorizerInput) UpdateAuthorizerRequest
UpdateAuthorizerRequest returns a request value for making API operation for Amazon API Gateway.
Updates an existing Authorizer resource.
AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-authorizer.html)
// Example sending a request using UpdateAuthorizerRequest. req := client.UpdateAuthorizerRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateBasePathMappingRequest ¶
func (c *Client) UpdateBasePathMappingRequest(input *UpdateBasePathMappingInput) UpdateBasePathMappingRequest
UpdateBasePathMappingRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about the BasePathMapping resource.
// Example sending a request using UpdateBasePathMappingRequest. req := client.UpdateBasePathMappingRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateClientCertificateRequest ¶
func (c *Client) UpdateClientCertificateRequest(input *UpdateClientCertificateInput) UpdateClientCertificateRequest
UpdateClientCertificateRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about an ClientCertificate resource.
// Example sending a request using UpdateClientCertificateRequest. req := client.UpdateClientCertificateRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateDeploymentRequest ¶
func (c *Client) UpdateDeploymentRequest(input *UpdateDeploymentInput) UpdateDeploymentRequest
UpdateDeploymentRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about a Deployment resource.
// Example sending a request using UpdateDeploymentRequest. req := client.UpdateDeploymentRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateDocumentationPartRequest ¶
func (c *Client) UpdateDocumentationPartRequest(input *UpdateDocumentationPartInput) UpdateDocumentationPartRequest
UpdateDocumentationPartRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using UpdateDocumentationPartRequest. req := client.UpdateDocumentationPartRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateDocumentationVersionRequest ¶
func (c *Client) UpdateDocumentationVersionRequest(input *UpdateDocumentationVersionInput) UpdateDocumentationVersionRequest
UpdateDocumentationVersionRequest returns a request value for making API operation for Amazon API Gateway.
// Example sending a request using UpdateDocumentationVersionRequest. req := client.UpdateDocumentationVersionRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateDomainNameRequest ¶
func (c *Client) UpdateDomainNameRequest(input *UpdateDomainNameInput) UpdateDomainNameRequest
UpdateDomainNameRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about the DomainName resource.
// Example sending a request using UpdateDomainNameRequest. req := client.UpdateDomainNameRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateGatewayResponseRequest ¶
func (c *Client) UpdateGatewayResponseRequest(input *UpdateGatewayResponseInput) UpdateGatewayResponseRequest
UpdateGatewayResponseRequest returns a request value for making API operation for Amazon API Gateway.
Updates a GatewayResponse of a specified response type on the given RestApi.
// Example sending a request using UpdateGatewayResponseRequest. req := client.UpdateGatewayResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateIntegrationRequest ¶
func (c *Client) UpdateIntegrationRequest(input *UpdateIntegrationInput) UpdateIntegrationRequest
UpdateIntegrationRequest returns a request value for making API operation for Amazon API Gateway.
Represents an update integration.
// Example sending a request using UpdateIntegrationRequest. req := client.UpdateIntegrationRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateIntegrationResponseRequest ¶
func (c *Client) UpdateIntegrationResponseRequest(input *UpdateIntegrationResponseInput) UpdateIntegrationResponseRequest
UpdateIntegrationResponseRequest returns a request value for making API operation for Amazon API Gateway.
Represents an update integration response.
// Example sending a request using UpdateIntegrationResponseRequest. req := client.UpdateIntegrationResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateMethodRequest ¶
func (c *Client) UpdateMethodRequest(input *UpdateMethodInput) UpdateMethodRequest
UpdateMethodRequest returns a request value for making API operation for Amazon API Gateway.
Updates an existing Method resource.
// Example sending a request using UpdateMethodRequest. req := client.UpdateMethodRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateMethodResponseRequest ¶
func (c *Client) UpdateMethodResponseRequest(input *UpdateMethodResponseInput) UpdateMethodResponseRequest
UpdateMethodResponseRequest returns a request value for making API operation for Amazon API Gateway.
Updates an existing MethodResponse resource.
// Example sending a request using UpdateMethodResponseRequest. req := client.UpdateMethodResponseRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateModelRequest ¶
func (c *Client) UpdateModelRequest(input *UpdateModelInput) UpdateModelRequest
UpdateModelRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about a model.
// Example sending a request using UpdateModelRequest. req := client.UpdateModelRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateRequestValidatorRequest ¶
func (c *Client) UpdateRequestValidatorRequest(input *UpdateRequestValidatorInput) UpdateRequestValidatorRequest
UpdateRequestValidatorRequest returns a request value for making API operation for Amazon API Gateway.
Updates a RequestValidator of a given RestApi.
// Example sending a request using UpdateRequestValidatorRequest. req := client.UpdateRequestValidatorRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateResourceRequest ¶
func (c *Client) UpdateResourceRequest(input *UpdateResourceInput) UpdateResourceRequest
UpdateResourceRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about a Resource resource.
// Example sending a request using UpdateResourceRequest. req := client.UpdateResourceRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateRestApiRequest ¶
func (c *Client) UpdateRestApiRequest(input *UpdateRestApiInput) UpdateRestApiRequest
UpdateRestApiRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about the specified API.
// Example sending a request using UpdateRestApiRequest. req := client.UpdateRestApiRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateStageRequest ¶
func (c *Client) UpdateStageRequest(input *UpdateStageInput) UpdateStageRequest
UpdateStageRequest returns a request value for making API operation for Amazon API Gateway.
Changes information about a Stage resource.
// Example sending a request using UpdateStageRequest. req := client.UpdateStageRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateUsagePlanRequest ¶
func (c *Client) UpdateUsagePlanRequest(input *UpdateUsagePlanInput) UpdateUsagePlanRequest
UpdateUsagePlanRequest returns a request value for making API operation for Amazon API Gateway.
Updates a usage plan of a given plan Id.
// Example sending a request using UpdateUsagePlanRequest. req := client.UpdateUsagePlanRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateUsageRequest ¶
func (c *Client) UpdateUsageRequest(input *UpdateUsageInput) UpdateUsageRequest
UpdateUsageRequest returns a request value for making API operation for Amazon API Gateway.
Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.
// Example sending a request using UpdateUsageRequest. req := client.UpdateUsageRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
func (*Client) UpdateVpcLinkRequest ¶
func (c *Client) UpdateVpcLinkRequest(input *UpdateVpcLinkInput) UpdateVpcLinkRequest
UpdateVpcLinkRequest returns a request value for making API operation for Amazon API Gateway.
Updates an existing VpcLink of a specified identifier.
// Example sending a request using UpdateVpcLinkRequest. req := client.UpdateVpcLinkRequest(params) resp, err := req.Send(context.TODO()) if err == nil { fmt.Println(resp) }
type ConnectionType ¶
type ConnectionType string
const ( ConnectionTypeInternet ConnectionType = "INTERNET" ConnectionTypeVpcLink ConnectionType = "VPC_LINK" )
Enum values for ConnectionType
func (ConnectionType) MarshalValue ¶
func (enum ConnectionType) MarshalValue() (string, error)
func (ConnectionType) MarshalValueBuf ¶
func (enum ConnectionType) MarshalValueBuf(b []byte) ([]byte, error)
type ContentHandlingStrategy ¶
type ContentHandlingStrategy string
const ( ContentHandlingStrategyConvertToBinary ContentHandlingStrategy = "CONVERT_TO_BINARY" ContentHandlingStrategyConvertToText ContentHandlingStrategy = "CONVERT_TO_TEXT" )
Enum values for ContentHandlingStrategy
func (ContentHandlingStrategy) MarshalValue ¶
func (enum ContentHandlingStrategy) MarshalValue() (string, error)
func (ContentHandlingStrategy) MarshalValueBuf ¶
func (enum ContentHandlingStrategy) MarshalValueBuf(b []byte) ([]byte, error)
type CreateApiKeyInput ¶
type CreateApiKeyInput struct { // An AWS Marketplace customer identifier , when integrating with the AWS SaaS // Marketplace. CustomerId *string `locationName:"customerId" type:"string"` // The description of the ApiKey. Description *string `locationName:"description" type:"string"` // Specifies whether the ApiKey can be used by callers. Enabled *bool `locationName:"enabled" type:"boolean"` // Specifies whether (true) or not (false) the key identifier is distinct from // the created API key value. GenerateDistinctId *bool `locationName:"generateDistinctId" type:"boolean"` // The name of the ApiKey. Name *string `locationName:"name" type:"string"` // DEPRECATED FOR USAGE PLANS - Specifies stages associated with the API key. StageKeys []StageKey `locationName:"stageKeys" type:"list"` // 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. Tags map[string]string `locationName:"tags" type:"map"` // Specifies a value of the API key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
Request to create an ApiKey resource.
func (CreateApiKeyInput) MarshalFields ¶
func (s CreateApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateApiKeyInput) String ¶
func (s CreateApiKeyInput) String() string
String returns the string representation
type CreateApiKeyOutput ¶
type CreateApiKeyOutput struct { // The timestamp when the API Key was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // An AWS Marketplace customer identifier , when integrating with the AWS SaaS // Marketplace. CustomerId *string `locationName:"customerId" type:"string"` // The description of the API Key. Description *string `locationName:"description" type:"string"` // Specifies whether the API Key can be used by callers. Enabled *bool `locationName:"enabled" type:"boolean"` // The identifier of the API Key. Id *string `locationName:"id" type:"string"` // The timestamp when the API Key was last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // The name of the API Key. Name *string `locationName:"name" type:"string"` // A list of Stage resources that are associated with the ApiKey resource. StageKeys []string `locationName:"stageKeys" type:"list"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The value of the API Key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
A resource that can be distributed to callers for executing Method resources that require an API key. API keys can be mapped to any Stage on any RestApi, which indicates that the callers with the API key can make requests to that stage.
Use API Keys (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-api-keys.html)
func (CreateApiKeyOutput) MarshalFields ¶
func (s CreateApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateApiKeyOutput) String ¶
func (s CreateApiKeyOutput) String() string
String returns the string representation
type CreateApiKeyRequest ¶
type CreateApiKeyRequest struct { *aws.Request Input *CreateApiKeyInput Copy func(*CreateApiKeyInput) CreateApiKeyRequest }
CreateApiKeyRequest is the request type for the CreateApiKey API operation.
func (CreateApiKeyRequest) Send ¶
func (r CreateApiKeyRequest) Send(ctx context.Context) (*CreateApiKeyResponse, error)
Send marshals and sends the CreateApiKey API request.
type CreateApiKeyResponse ¶
type CreateApiKeyResponse struct { *CreateApiKeyOutput // contains filtered or unexported fields }
CreateApiKeyResponse is the response type for the CreateApiKey API operation.
func (*CreateApiKeyResponse) SDKResponseMetdata ¶
func (r *CreateApiKeyResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateApiKey request.
type CreateAuthorizerInput ¶
type CreateAuthorizerInput struct { // Optional customer-defined field, used in OpenAPI imports and exports without // functional impact. AuthType *string `locationName:"authType" type:"string"` // Specifies the required credentials as an IAM role for API Gateway to invoke // the authorizer. To specify an IAM role for API Gateway to assume, use the // role's Amazon Resource Name (ARN). To use resource-based permissions on the // Lambda function, specify null. AuthorizerCredentials *string `locationName:"authorizerCredentials" type:"string"` // The TTL in seconds of cached authorizer results. If it equals 0, authorization // caching is disabled. If it is greater than 0, API Gateway will cache authorizer // responses. If this field is not set, the default value is 300. The maximum // value is 3600, or 1 hour. AuthorizerResultTtlInSeconds *int64 `locationName:"authorizerResultTtlInSeconds" type:"integer"` // Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN or // REQUEST authorizers, this must be a well-formed Lambda function URI, for // example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations. // In general, the URI has this form arn:aws:apigateway:{region}:lambda:path/{service_api}, // where {region} is the same as the region hosting the Lambda function, path // indicates that the remaining substring in the URI should be treated as the // path to the resource, including the initial /. For Lambda functions, this // is usually of the form /2015-03-31/functions/[FunctionARN]/invocations. AuthorizerUri *string `locationName:"authorizerUri" type:"string"` // The identity source for which authorization is requested. // * For a TOKEN or COGNITO_USER_POOLS authorizer, this is required and specifies // the request header mapping expression for the custom header holding the // authorization token submitted by the client. For example, if the token // header name is Auth, the header mapping expression is method.request.header.Auth. // // * For the REQUEST authorizer, this is required when authorization caching // is enabled. The value is a comma-separated string of one or more mapping // expressions of the specified request parameters. For example, if an Auth // header, a Name query string parameter are defined as identity sources, // this value is method.request.header.Auth, method.request.querystring.Name. // These parameters will be used to derive the authorization caching key // and to perform runtime validation of the REQUEST authorizer by verifying // all of the identity-related request parameters are present, not null and // non-empty. Only when this is true does the authorizer invoke the authorizer // Lambda function, otherwise, it returns a 401 Unauthorized response without // calling the Lambda function. The valid value is a string of comma-separated // mapping expressions of the specified request parameters. When the authorization // caching is not enabled, this property is optional. IdentitySource *string `locationName:"identitySource" type:"string"` // A validation expression for the incoming identity token. For TOKEN authorizers, // this value is a regular expression. For COGNITO_USER_POOLS authorizers, API // Gateway will match the aud field of the incoming token from the client against // the specified regular expression. It will invoke the authorizer's Lambda // function when there is a match. Otherwise, it will return a 401 Unauthorized // response without calling the Lambda function. The validation expression does // not apply to the REQUEST authorizer. IdentityValidationExpression *string `locationName:"identityValidationExpression" type:"string"` // [Required] The name of the authorizer. // // Name is a required field Name *string `locationName:"name" type:"string" required:"true"` // A list of the Amazon Cognito user pool ARNs for the COGNITO_USER_POOLS authorizer. // Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}. // For a TOKEN or REQUEST authorizer, this is not defined. ProviderARNs []string `locationName:"providerARNs" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The authorizer type. Valid values are TOKEN for a Lambda function // using a single authorization token submitted in a custom header, REQUEST // for a Lambda function using incoming request parameters, and COGNITO_USER_POOLS // for using an Amazon Cognito user pool. // // Type is a required field Type AuthorizerType `locationName:"type" type:"string" required:"true" enum:"true"` // contains filtered or unexported fields }
Request to add a new Authorizer to an existing RestApi resource.
func (CreateAuthorizerInput) MarshalFields ¶
func (s CreateAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateAuthorizerInput) String ¶
func (s CreateAuthorizerInput) String() string
String returns the string representation
func (*CreateAuthorizerInput) Validate ¶
func (s *CreateAuthorizerInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateAuthorizerOutput ¶
type CreateAuthorizerOutput struct { // Optional customer-defined field, used in OpenAPI imports and exports without // functional impact. AuthType *string `locationName:"authType" type:"string"` // Specifies the required credentials as an IAM role for API Gateway to invoke // the authorizer. To specify an IAM role for API Gateway to assume, use the // role's Amazon Resource Name (ARN). To use resource-based permissions on the // Lambda function, specify null. AuthorizerCredentials *string `locationName:"authorizerCredentials" type:"string"` // The TTL in seconds of cached authorizer results. If it equals 0, authorization // caching is disabled. If it is greater than 0, API Gateway will cache authorizer // responses. If this field is not set, the default value is 300. The maximum // value is 3600, or 1 hour. AuthorizerResultTtlInSeconds *int64 `locationName:"authorizerResultTtlInSeconds" type:"integer"` // Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN or // REQUEST authorizers, this must be a well-formed Lambda function URI, for // example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations. // In general, the URI has this form arn:aws:apigateway:{region}:lambda:path/{service_api}, // where {region} is the same as the region hosting the Lambda function, path // indicates that the remaining substring in the URI should be treated as the // path to the resource, including the initial /. For Lambda functions, this // is usually of the form /2015-03-31/functions/[FunctionARN]/invocations. AuthorizerUri *string `locationName:"authorizerUri" type:"string"` // The identifier for the authorizer resource. Id *string `locationName:"id" type:"string"` // The identity source for which authorization is requested. // * For a TOKEN or COGNITO_USER_POOLS authorizer, this is required and specifies // the request header mapping expression for the custom header holding the // authorization token submitted by the client. For example, if the token // header name is Auth, the header mapping expression is method.request.header.Auth. // // * For the REQUEST authorizer, this is required when authorization caching // is enabled. The value is a comma-separated string of one or more mapping // expressions of the specified request parameters. For example, if an Auth // header, a Name query string parameter are defined as identity sources, // this value is method.request.header.Auth, method.request.querystring.Name. // These parameters will be used to derive the authorization caching key // and to perform runtime validation of the REQUEST authorizer by verifying // all of the identity-related request parameters are present, not null and // non-empty. Only when this is true does the authorizer invoke the authorizer // Lambda function, otherwise, it returns a 401 Unauthorized response without // calling the Lambda function. The valid value is a string of comma-separated // mapping expressions of the specified request parameters. When the authorization // caching is not enabled, this property is optional. IdentitySource *string `locationName:"identitySource" type:"string"` // A validation expression for the incoming identity token. For TOKEN authorizers, // this value is a regular expression. For COGNITO_USER_POOLS authorizers, API // Gateway will match the aud field of the incoming token from the client against // the specified regular expression. It will invoke the authorizer's Lambda // function when there is a match. Otherwise, it will return a 401 Unauthorized // response without calling the Lambda function. The validation expression does // not apply to the REQUEST authorizer. IdentityValidationExpression *string `locationName:"identityValidationExpression" type:"string"` // [Required] The name of the authorizer. Name *string `locationName:"name" type:"string"` // A list of the Amazon Cognito user pool ARNs for the COGNITO_USER_POOLS authorizer. // Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}. // For a TOKEN or REQUEST authorizer, this is not defined. ProviderARNs []string `locationName:"providerARNs" type:"list"` // The authorizer type. Valid values are TOKEN for a Lambda function using a // single authorization token submitted in a custom header, REQUEST for a Lambda // function using incoming request parameters, and COGNITO_USER_POOLS for using // an Amazon Cognito user pool. Type AuthorizerType `locationName:"type" type:"string" enum:"true"` // contains filtered or unexported fields }
Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.
Use Lambda Function as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html) Use Cognito User Pool as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html)
func (CreateAuthorizerOutput) MarshalFields ¶
func (s CreateAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateAuthorizerOutput) String ¶
func (s CreateAuthorizerOutput) String() string
String returns the string representation
type CreateAuthorizerRequest ¶
type CreateAuthorizerRequest struct { *aws.Request Input *CreateAuthorizerInput Copy func(*CreateAuthorizerInput) CreateAuthorizerRequest }
CreateAuthorizerRequest is the request type for the CreateAuthorizer API operation.
func (CreateAuthorizerRequest) Send ¶
func (r CreateAuthorizerRequest) Send(ctx context.Context) (*CreateAuthorizerResponse, error)
Send marshals and sends the CreateAuthorizer API request.
type CreateAuthorizerResponse ¶
type CreateAuthorizerResponse struct { *CreateAuthorizerOutput // contains filtered or unexported fields }
CreateAuthorizerResponse is the response type for the CreateAuthorizer API operation.
func (*CreateAuthorizerResponse) SDKResponseMetdata ¶
func (r *CreateAuthorizerResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateAuthorizer request.
type CreateBasePathMappingInput ¶
type CreateBasePathMappingInput struct { // The base path name that callers of the API must provide as part of the URL // after the domain name. This value must be unique for all of the mappings // across a single API. Specify '(none)' if you do not want callers to specify // a base path name after the domain name. BasePath *string `locationName:"basePath" type:"string"` // [Required] The domain name of the BasePathMapping resource to create. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `locationName:"restApiId" type:"string" required:"true"` // The name of the API's stage that you want to use for this mapping. Specify // '(none)' if you do not want callers to explicitly specify the stage name // after any base path name. Stage *string `locationName:"stage" type:"string"` // contains filtered or unexported fields }
Requests API Gateway to create a new BasePathMapping resource.
func (CreateBasePathMappingInput) MarshalFields ¶
func (s CreateBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateBasePathMappingInput) String ¶
func (s CreateBasePathMappingInput) String() string
String returns the string representation
func (*CreateBasePathMappingInput) Validate ¶
func (s *CreateBasePathMappingInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateBasePathMappingOutput ¶
type CreateBasePathMappingOutput struct { // The base path name that callers of the API must provide as part of the URL // after the domain name. BasePath *string `locationName:"basePath" type:"string"` // The string identifier of the associated RestApi. RestApiId *string `locationName:"restApiId" type:"string"` // The name of the associated stage. Stage *string `locationName:"stage" type:"string"` // contains filtered or unexported fields }
Represents the base path that callers of the API must provide as part of the URL after the domain name.
A custom domain name plus a BasePathMapping specification identifies a deployed RestApi in a given stage of the owner Account.
Use Custom Domain Names (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (CreateBasePathMappingOutput) MarshalFields ¶
func (s CreateBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateBasePathMappingOutput) String ¶
func (s CreateBasePathMappingOutput) String() string
String returns the string representation
type CreateBasePathMappingRequest ¶
type CreateBasePathMappingRequest struct { *aws.Request Input *CreateBasePathMappingInput Copy func(*CreateBasePathMappingInput) CreateBasePathMappingRequest }
CreateBasePathMappingRequest is the request type for the CreateBasePathMapping API operation.
func (CreateBasePathMappingRequest) Send ¶
func (r CreateBasePathMappingRequest) Send(ctx context.Context) (*CreateBasePathMappingResponse, error)
Send marshals and sends the CreateBasePathMapping API request.
type CreateBasePathMappingResponse ¶
type CreateBasePathMappingResponse struct { *CreateBasePathMappingOutput // contains filtered or unexported fields }
CreateBasePathMappingResponse is the response type for the CreateBasePathMapping API operation.
func (*CreateBasePathMappingResponse) SDKResponseMetdata ¶
func (r *CreateBasePathMappingResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateBasePathMapping request.
type CreateDeploymentInput ¶
type CreateDeploymentInput struct { // Enables a cache cluster for the Stage resource specified in the input. CacheClusterEnabled *bool `locationName:"cacheClusterEnabled" type:"boolean"` // Specifies the cache cluster size for the Stage resource specified in the // input, if a cache cluster is enabled. CacheClusterSize CacheClusterSize `locationName:"cacheClusterSize" type:"string" enum:"true"` // The input configuration for the canary deployment when the deployment is // a canary release deployment. CanarySettings *DeploymentCanarySettings `locationName:"canarySettings" type:"structure"` // The description for the Deployment resource to create. Description *string `locationName:"description" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // The description of the Stage resource for the Deployment resource to create. StageDescription *string `locationName:"stageDescription" type:"string"` // The name of the Stage resource for the Deployment resource to create. StageName *string `locationName:"stageName" type:"string"` // Specifies whether active tracing with X-ray is enabled for the Stage. TracingEnabled *bool `locationName:"tracingEnabled" type:"boolean"` // A map that defines the stage variables for the Stage resource that is associated // with the new deployment. Variable names can have alphanumeric and underscore // characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+. Variables map[string]string `locationName:"variables" type:"map"` // contains filtered or unexported fields }
Requests API Gateway to create a Deployment resource.
func (CreateDeploymentInput) MarshalFields ¶
func (s CreateDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDeploymentInput) String ¶
func (s CreateDeploymentInput) String() string
String returns the string representation
func (*CreateDeploymentInput) Validate ¶
func (s *CreateDeploymentInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateDeploymentOutput ¶
type CreateDeploymentOutput struct { // A summary of the RestApi at the date and time that the deployment resource // was created. ApiSummary map[string]map[string]MethodSnapshot `locationName:"apiSummary" type:"map"` // The date and time that the deployment resource was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description for the deployment resource. Description *string `locationName:"description" type:"string"` // The identifier for the deployment resource. Id *string `locationName:"id" type:"string"` // contains filtered or unexported fields }
An immutable representation of a RestApi resource that can be called by users using Stages. A deployment must be associated with a Stage for it to be callable over the Internet.
To create a deployment, call POST on the Deployments resource of a RestApi. To view, update, or delete a deployment, call GET, PATCH, or DELETE on the specified deployment resource (/restapis/{restapi_id}/deployments/{deployment_id}).
RestApi, Deployments, Stage, AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-deployment.html), AWS SDKs (https://aws.amazon.com/tools/)
func (CreateDeploymentOutput) MarshalFields ¶
func (s CreateDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDeploymentOutput) String ¶
func (s CreateDeploymentOutput) String() string
String returns the string representation
type CreateDeploymentRequest ¶
type CreateDeploymentRequest struct { *aws.Request Input *CreateDeploymentInput Copy func(*CreateDeploymentInput) CreateDeploymentRequest }
CreateDeploymentRequest is the request type for the CreateDeployment API operation.
func (CreateDeploymentRequest) Send ¶
func (r CreateDeploymentRequest) Send(ctx context.Context) (*CreateDeploymentResponse, error)
Send marshals and sends the CreateDeployment API request.
type CreateDeploymentResponse ¶
type CreateDeploymentResponse struct { *CreateDeploymentOutput // contains filtered or unexported fields }
CreateDeploymentResponse is the response type for the CreateDeployment API operation.
func (*CreateDeploymentResponse) SDKResponseMetdata ¶
func (r *CreateDeploymentResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateDeployment request.
type CreateDocumentationPartInput ¶
type CreateDocumentationPartInput struct { // [Required] The location of the targeted API entity of the to-be-created documentation // part. // // Location is a required field Location *DocumentationPartLocation `locationName:"location" type:"structure" required:"true"` // [Required] 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. // // Properties is a required field Properties *string `locationName:"properties" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Creates a new documentation part of a given API.
func (CreateDocumentationPartInput) MarshalFields ¶
func (s CreateDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDocumentationPartInput) String ¶
func (s CreateDocumentationPartInput) String() string
String returns the string representation
func (*CreateDocumentationPartInput) Validate ¶
func (s *CreateDocumentationPartInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateDocumentationPartOutput ¶
type CreateDocumentationPartOutput struct { // The DocumentationPart identifier, generated by API Gateway when the DocumentationPart // is created. Id *string `locationName:"id" type:"string"` // The location of the API entity to which the documentation applies. Valid // fields depend on the targeted API entity type. All the valid location fields // are not required. If not explicitly specified, a valid location field is // treated as a wildcard and associated documentation content may be inherited // by matching entities, unless overridden. Location *DocumentationPartLocation `locationName:"location" type:"structure"` // 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 OpenAPI-compliant documentation-related fields // from the properties map are exported and, hence, published as part of the // API entity definitions, while the original documentation parts are exported // in a OpenAPI extension of x-amazon-apigateway-documentation. Properties *string `locationName:"properties" type:"string"` // contains filtered or unexported fields }
A documentation part for a targeted API entity.
A documentation part consists of a content map (properties) and a target (location). The target specifies an API entity to which the documentation content applies. The supported API entity types are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Valid location fields depend on the API entity type. All valid fields are not required.
The content map is a JSON string of API-specific key-value pairs. Although an API can use any shape for the content map, only the OpenAPI-compliant documentation fields will be injected into the associated API entity definition in the exported OpenAPI definition file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationParts
func (CreateDocumentationPartOutput) MarshalFields ¶
func (s CreateDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDocumentationPartOutput) String ¶
func (s CreateDocumentationPartOutput) String() string
String returns the string representation
type CreateDocumentationPartRequest ¶
type CreateDocumentationPartRequest struct { *aws.Request Input *CreateDocumentationPartInput Copy func(*CreateDocumentationPartInput) CreateDocumentationPartRequest }
CreateDocumentationPartRequest is the request type for the CreateDocumentationPart API operation.
func (CreateDocumentationPartRequest) Send ¶
func (r CreateDocumentationPartRequest) Send(ctx context.Context) (*CreateDocumentationPartResponse, error)
Send marshals and sends the CreateDocumentationPart API request.
type CreateDocumentationPartResponse ¶
type CreateDocumentationPartResponse struct { *CreateDocumentationPartOutput // contains filtered or unexported fields }
CreateDocumentationPartResponse is the response type for the CreateDocumentationPart API operation.
func (*CreateDocumentationPartResponse) SDKResponseMetdata ¶
func (r *CreateDocumentationPartResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateDocumentationPart request.
type CreateDocumentationVersionInput ¶
type CreateDocumentationVersionInput struct { // A description about the new documentation snapshot. Description *string `locationName:"description" type:"string"` // [Required] The version identifier of the new snapshot. // // DocumentationVersion is a required field DocumentationVersion *string `locationName:"documentationVersion" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // The stage name to be associated with the new documentation snapshot. StageName *string `locationName:"stageName" type:"string"` // contains filtered or unexported fields }
Creates a new documentation version of a given API.
func (CreateDocumentationVersionInput) MarshalFields ¶
func (s CreateDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDocumentationVersionInput) String ¶
func (s CreateDocumentationVersionInput) String() string
String returns the string representation
func (*CreateDocumentationVersionInput) Validate ¶
func (s *CreateDocumentationVersionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateDocumentationVersionOutput ¶
type CreateDocumentationVersionOutput struct { // The date when the API documentation snapshot is created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the API documentation snapshot. Description *string `locationName:"description" type:"string"` // The version identifier of the API documentation snapshot. Version *string `locationName:"version" type:"string"` // contains filtered or unexported fields }
A snapshot of the documentation of an API.
Publishing API documentation involves creating a documentation version associated with an API stage and exporting the versioned documentation to an external (e.g., OpenAPI) file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationPart, DocumentationVersions
func (CreateDocumentationVersionOutput) MarshalFields ¶
func (s CreateDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDocumentationVersionOutput) String ¶
func (s CreateDocumentationVersionOutput) String() string
String returns the string representation
type CreateDocumentationVersionRequest ¶
type CreateDocumentationVersionRequest struct { *aws.Request Input *CreateDocumentationVersionInput Copy func(*CreateDocumentationVersionInput) CreateDocumentationVersionRequest }
CreateDocumentationVersionRequest is the request type for the CreateDocumentationVersion API operation.
func (CreateDocumentationVersionRequest) Send ¶
func (r CreateDocumentationVersionRequest) Send(ctx context.Context) (*CreateDocumentationVersionResponse, error)
Send marshals and sends the CreateDocumentationVersion API request.
type CreateDocumentationVersionResponse ¶
type CreateDocumentationVersionResponse struct { *CreateDocumentationVersionOutput // contains filtered or unexported fields }
CreateDocumentationVersionResponse is the response type for the CreateDocumentationVersion API operation.
func (*CreateDocumentationVersionResponse) SDKResponseMetdata ¶
func (r *CreateDocumentationVersionResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateDocumentationVersion request.
type CreateDomainNameInput ¶
type CreateDomainNameInput struct { // The reference to an AWS-managed certificate that will be used by edge-optimized // endpoint for this domain name. AWS Certificate Manager is the only supported // source. CertificateArn *string `locationName:"certificateArn" type:"string"` // [Deprecated] The body of the server certificate that will be used by edge-optimized // endpoint for this domain name provided by your certificate authority. CertificateBody *string `locationName:"certificateBody" type:"string"` // [Deprecated] The intermediate certificates and optionally the root certificate, // one after the other without any blank lines, used by an edge-optimized endpoint // for this domain name. If you include the root certificate, your certificate // chain must start with intermediate certificates and end with the root certificate. // Use the intermediate certificates that were provided by your certificate // authority. Do not include any intermediaries that are not in the chain of // trust path. CertificateChain *string `locationName:"certificateChain" type:"string"` // The user-friendly name of the certificate that will be used by edge-optimized // endpoint for this domain name. CertificateName *string `locationName:"certificateName" type:"string"` // [Deprecated] Your edge-optimized endpoint's domain name certificate's private // key. CertificatePrivateKey *string `locationName:"certificatePrivateKey" type:"string"` // [Required] The name of the DomainName resource. // // DomainName is a required field DomainName *string `locationName:"domainName" type:"string" required:"true"` // The endpoint configuration of this DomainName showing the endpoint types // of the domain name. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The reference to an AWS-managed certificate that will be used by regional // endpoint for this domain name. AWS Certificate Manager is the only supported // source. RegionalCertificateArn *string `locationName:"regionalCertificateArn" type:"string"` // The user-friendly name of the certificate that will be used by regional endpoint // for this domain name. RegionalCertificateName *string `locationName:"regionalCertificateName" type:"string"` // The Transport Layer Security (TLS) version + cipher suite for this DomainName. // The valid values are TLS_1_0 and TLS_1_2. SecurityPolicy SecurityPolicy `locationName:"securityPolicy" type:"string" enum:"true"` // 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. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
A request to create a new domain name.
func (CreateDomainNameInput) MarshalFields ¶
func (s CreateDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDomainNameInput) String ¶
func (s CreateDomainNameInput) String() string
String returns the string representation
func (*CreateDomainNameInput) Validate ¶
func (s *CreateDomainNameInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateDomainNameOutput ¶
type CreateDomainNameOutput struct { // The reference to an AWS-managed certificate that will be used by edge-optimized // endpoint for this domain name. AWS Certificate Manager is the only supported // source. CertificateArn *string `locationName:"certificateArn" type:"string"` // The name of the certificate that will be used by edge-optimized endpoint // for this domain name. CertificateName *string `locationName:"certificateName" type:"string"` // The timestamp when the certificate that was used by edge-optimized endpoint // for this domain name was uploaded. CertificateUploadDate *time.Time `locationName:"certificateUploadDate" type:"timestamp"` // The domain name of the Amazon CloudFront distribution associated with this // custom domain name for an edge-optimized endpoint. You set up this association // when adding a DNS record pointing the custom domain name to this distribution // name. For more information about CloudFront distributions, see the Amazon // CloudFront documentation (https://aws.amazon.com/documentation/cloudfront/). DistributionDomainName *string `locationName:"distributionDomainName" type:"string"` // The region-agnostic Amazon Route 53 Hosted Zone ID of the edge-optimized // endpoint. The valid value is Z2FDTNDATAQYW2 for all the regions. For more // information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). DistributionHostedZoneId *string `locationName:"distributionHostedZoneId" type:"string"` // The custom domain name as an API host name, for example, my-api.example.com. DomainName *string `locationName:"domainName" type:"string"` // The status of the DomainName migration. The valid values are AVAILABLE and // UPDATING. If the status is UPDATING, the domain cannot be modified further // until the existing operation is complete. If it is AVAILABLE, the domain // can be updated. DomainNameStatus DomainNameStatus `locationName:"domainNameStatus" type:"string" enum:"true"` // An optional text message containing detailed information about status of // the DomainName migration. DomainNameStatusMessage *string `locationName:"domainNameStatusMessage" type:"string"` // The endpoint configuration of this DomainName showing the endpoint types // of the domain name. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The reference to an AWS-managed certificate that will be used for validating // the regional domain name. AWS Certificate Manager is the only supported source. RegionalCertificateArn *string `locationName:"regionalCertificateArn" type:"string"` // The name of the certificate that will be used for validating the regional // domain name. RegionalCertificateName *string `locationName:"regionalCertificateName" type:"string"` // The domain name associated with the regional endpoint for this custom domain // name. You set up this association by adding a DNS record that points the // custom domain name to this regional domain name. The regional domain name // is returned by API Gateway when you create a regional endpoint. RegionalDomainName *string `locationName:"regionalDomainName" type:"string"` // The region-specific Amazon Route 53 Hosted Zone ID of the regional endpoint. // For more information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). RegionalHostedZoneId *string `locationName:"regionalHostedZoneId" type:"string"` // The Transport Layer Security (TLS) version + cipher suite for this DomainName. // The valid values are TLS_1_0 and TLS_1_2. SecurityPolicy SecurityPolicy `locationName:"securityPolicy" type:"string" enum:"true"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a custom domain name as a user-friendly host name of an API (RestApi).
When you deploy an API, API Gateway creates a default host name for the API. This default API host name is of the {restapi-id}.execute-api.{region}.amazonaws.com format. With the default host name, you can access the API's root resource with the URL of https://{restapi-id}.execute-api.{region}.amazonaws.com/{stage}/. When you set up a custom domain name of apis.example.com for this API, you can then access the same resource using the URL of the https://apis.examples.com/myApi, where myApi is the base path mapping (BasePathMapping) of your API under the custom domain name.
Set a Custom Host Name for an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (CreateDomainNameOutput) MarshalFields ¶
func (s CreateDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateDomainNameOutput) String ¶
func (s CreateDomainNameOutput) String() string
String returns the string representation
type CreateDomainNameRequest ¶
type CreateDomainNameRequest struct { *aws.Request Input *CreateDomainNameInput Copy func(*CreateDomainNameInput) CreateDomainNameRequest }
CreateDomainNameRequest is the request type for the CreateDomainName API operation.
func (CreateDomainNameRequest) Send ¶
func (r CreateDomainNameRequest) Send(ctx context.Context) (*CreateDomainNameResponse, error)
Send marshals and sends the CreateDomainName API request.
type CreateDomainNameResponse ¶
type CreateDomainNameResponse struct { *CreateDomainNameOutput // contains filtered or unexported fields }
CreateDomainNameResponse is the response type for the CreateDomainName API operation.
func (*CreateDomainNameResponse) SDKResponseMetdata ¶
func (r *CreateDomainNameResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateDomainName request.
type CreateModelInput ¶
type CreateModelInput struct { // [Required] The content-type for the model. // // ContentType is a required field ContentType *string `locationName:"contentType" type:"string" required:"true"` // The description of the model. Description *string `locationName:"description" type:"string"` // [Required] The name of the model. Must be alphanumeric. // // Name is a required field Name *string `locationName:"name" type:"string" required:"true"` // [Required] The RestApi identifier under which the Model will be created. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // The schema for the model. For application/json models, this should be JSON // schema draft 4 (https://tools.ietf.org/html/draft-zyp-json-schema-04) model. Schema *string `locationName:"schema" type:"string"` // contains filtered or unexported fields }
Request to add a new Model to an existing RestApi resource.
func (CreateModelInput) MarshalFields ¶
func (s CreateModelInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateModelInput) String ¶
func (s CreateModelInput) String() string
String returns the string representation
func (*CreateModelInput) Validate ¶
func (s *CreateModelInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateModelOutput ¶
type CreateModelOutput struct { // The content-type for the model. ContentType *string `locationName:"contentType" type:"string"` // The description of the model. Description *string `locationName:"description" type:"string"` // The identifier for the model resource. Id *string `locationName:"id" type:"string"` // The name of the model. Must be an alphanumeric string. Name *string `locationName:"name" type:"string"` // The schema for the model. For application/json models, this should be JSON // schema draft 4 (https://tools.ietf.org/html/draft-zyp-json-schema-04) model. // Do not include "\*/" characters in the description of any properties because // such "\*/" characters may be interpreted as the closing marker for comments // in some languages, such as Java or JavaScript, causing the installation of // your API's SDK generated by API Gateway to fail. Schema *string `locationName:"schema" type:"string"` // contains filtered or unexported fields }
Represents the data structure of a method's request or response payload.
A request model defines the data structure of the client-supplied request payload. A response model defines the data structure of the response payload returned by the back end. Although not required, models are useful for mapping payloads between the front end and back end.
A model is used for generating an API's SDK, validating the input request body, and creating a skeletal mapping template.
Method, MethodResponse, Models and Mappings (https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html)
func (CreateModelOutput) MarshalFields ¶
func (s CreateModelOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateModelOutput) String ¶
func (s CreateModelOutput) String() string
String returns the string representation
type CreateModelRequest ¶
type CreateModelRequest struct { *aws.Request Input *CreateModelInput Copy func(*CreateModelInput) CreateModelRequest }
CreateModelRequest is the request type for the CreateModel API operation.
func (CreateModelRequest) Send ¶
func (r CreateModelRequest) Send(ctx context.Context) (*CreateModelResponse, error)
Send marshals and sends the CreateModel API request.
type CreateModelResponse ¶
type CreateModelResponse struct { *CreateModelOutput // contains filtered or unexported fields }
CreateModelResponse is the response type for the CreateModel API operation.
func (*CreateModelResponse) SDKResponseMetdata ¶
func (r *CreateModelResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateModel request.
type CreateRequestValidatorInput ¶
type CreateRequestValidatorInput struct { // The name of the to-be-created RequestValidator. Name *string `locationName:"name" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // A Boolean flag to indicate whether to validate request body according to // the configured model schema for the method (true) or not (false). ValidateRequestBody *bool `locationName:"validateRequestBody" type:"boolean"` // A Boolean flag to indicate whether to validate request parameters, true, // or not false. ValidateRequestParameters *bool `locationName:"validateRequestParameters" type:"boolean"` // contains filtered or unexported fields }
Creates a RequestValidator of a given RestApi.
func (CreateRequestValidatorInput) MarshalFields ¶
func (s CreateRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateRequestValidatorInput) String ¶
func (s CreateRequestValidatorInput) String() string
String returns the string representation
func (*CreateRequestValidatorInput) Validate ¶
func (s *CreateRequestValidatorInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateRequestValidatorOutput ¶
type CreateRequestValidatorOutput struct { // The identifier of this RequestValidator. Id *string `locationName:"id" type:"string"` // The name of this RequestValidator Name *string `locationName:"name" type:"string"` // A Boolean flag to indicate whether to validate a request body according to // the configured Model schema. ValidateRequestBody *bool `locationName:"validateRequestBody" type:"boolean"` // A Boolean flag to indicate whether to validate request parameters (true) // or not (false). ValidateRequestParameters *bool `locationName:"validateRequestParameters" type:"boolean"` // contains filtered or unexported fields }
A set of validation rules for incoming Method requests.
In OpenAPI, a RequestValidator of an API is defined by the x-amazon-apigateway-request-validators.requestValidator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.requestValidator.html) object. It the referenced using the x-amazon-apigateway-request-validator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validator) property.
Enable Basic Request Validation in API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
func (CreateRequestValidatorOutput) MarshalFields ¶
func (s CreateRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateRequestValidatorOutput) String ¶
func (s CreateRequestValidatorOutput) String() string
String returns the string representation
type CreateRequestValidatorRequest ¶
type CreateRequestValidatorRequest struct { *aws.Request Input *CreateRequestValidatorInput Copy func(*CreateRequestValidatorInput) CreateRequestValidatorRequest }
CreateRequestValidatorRequest is the request type for the CreateRequestValidator API operation.
func (CreateRequestValidatorRequest) Send ¶
func (r CreateRequestValidatorRequest) Send(ctx context.Context) (*CreateRequestValidatorResponse, error)
Send marshals and sends the CreateRequestValidator API request.
type CreateRequestValidatorResponse ¶
type CreateRequestValidatorResponse struct { *CreateRequestValidatorOutput // contains filtered or unexported fields }
CreateRequestValidatorResponse is the response type for the CreateRequestValidator API operation.
func (*CreateRequestValidatorResponse) SDKResponseMetdata ¶
func (r *CreateRequestValidatorResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateRequestValidator request.
type CreateResourceInput ¶
type CreateResourceInput struct { // [Required] The parent resource's identifier. // // ParentId is a required field ParentId *string `location:"uri" locationName:"parent_id" type:"string" required:"true"` // The last path segment for this resource. // // PathPart is a required field PathPart *string `locationName:"pathPart" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to create a Resource resource.
func (CreateResourceInput) MarshalFields ¶
func (s CreateResourceInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateResourceInput) String ¶
func (s CreateResourceInput) String() string
String returns the string representation
func (*CreateResourceInput) Validate ¶
func (s *CreateResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateResourceOutput ¶
type CreateResourceOutput struct { // The resource's identifier. Id *string `locationName:"id" type:"string"` // The parent resource's identifier. ParentId *string `locationName:"parentId" type:"string"` // The full path for this resource. Path *string `locationName:"path" type:"string"` // The last path segment for this resource. PathPart *string `locationName:"pathPart" type:"string"` // Gets an API resource's method of a given HTTP verb. // // The resource methods are a map of methods indexed by methods' HTTP verbs // enabled on the resource. This method map is included in the 200 OK response // of the GET /restapis/{restapi_id}/resources/{resource_id} or GET /restapis/{restapi_id}/resources/{resource_id}?embed=methods // request. // // Example: Get the GET method of an API resource // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: // application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20170223T031827Z // Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20170223/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", // "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", // "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", // "templated": true } }, "apiKeyRequired": false, "authorizationType": "NONE", // "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { // "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": // "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": // "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": // { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.Content-Type": false }, "statusCode": "200" } // } } // If the OPTIONS is enabled on the resource, you can follow the example here // to get that method. Just replace the GET of the last path segment in the // request URL with OPTIONS. ResourceMethods map[string]Method `locationName:"resourceMethods" type:"map"` // contains filtered or unexported fields }
Represents an API resource.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (CreateResourceOutput) MarshalFields ¶
func (s CreateResourceOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateResourceOutput) String ¶
func (s CreateResourceOutput) String() string
String returns the string representation
type CreateResourceRequest ¶
type CreateResourceRequest struct { *aws.Request Input *CreateResourceInput Copy func(*CreateResourceInput) CreateResourceRequest }
CreateResourceRequest is the request type for the CreateResource API operation.
func (CreateResourceRequest) Send ¶
func (r CreateResourceRequest) Send(ctx context.Context) (*CreateResourceResponse, error)
Send marshals and sends the CreateResource API request.
type CreateResourceResponse ¶
type CreateResourceResponse struct { *CreateResourceOutput // contains filtered or unexported fields }
CreateResourceResponse is the response type for the CreateResource API operation.
func (*CreateResourceResponse) SDKResponseMetdata ¶
func (r *CreateResourceResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateResource request.
type CreateRestApiInput ¶
type CreateRestApiInput struct { // 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. ApiKeySource ApiKeySourceType `locationName:"apiKeySource" type:"string" enum:"true"` // The list of binary media types supported by the RestApi. By default, the // RestApi supports only UTF-8-encoded text payloads. BinaryMediaTypes []string `locationName:"binaryMediaTypes" type:"list"` // The ID of the RestApi that you want to clone from. CloneFrom *string `locationName:"cloneFrom" type:"string"` // The description of the RestApi. Description *string `locationName:"description" type:"string"` // The endpoint configuration of this RestApi showing the endpoint types of // the API. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // 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. MinimumCompressionSize *int64 `locationName:"minimumCompressionSize" type:"integer"` // [Required] The name of the RestApi. // // Name is a required field Name *string `locationName:"name" type:"string" required:"true"` // A stringified JSON policy document that applies to this RestApi regardless // of the caller and Method configuration. Policy *string `locationName:"policy" type:"string"` // 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. Tags map[string]string `locationName:"tags" type:"map"` // A version identifier for the API. Version *string `locationName:"version" type:"string"` // contains filtered or unexported fields }
The POST Request to add a new RestApi resource to your collection.
func (CreateRestApiInput) MarshalFields ¶
func (s CreateRestApiInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateRestApiInput) String ¶
func (s CreateRestApiInput) String() string
String returns the string representation
func (*CreateRestApiInput) Validate ¶
func (s *CreateRestApiInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateRestApiOutput ¶
type CreateRestApiOutput struct { // 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. ApiKeySource ApiKeySourceType `locationName:"apiKeySource" type:"string" enum:"true"` // The list of binary media types supported by the RestApi. By default, the // RestApi supports only UTF-8-encoded text payloads. BinaryMediaTypes []string `locationName:"binaryMediaTypes" type:"list"` // The timestamp when the API was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The API's description. Description *string `locationName:"description" type:"string"` // The endpoint configuration of this RestApi showing the endpoint types of // the API. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The API's identifier. This identifier is unique across all of your APIs in // API Gateway. Id *string `locationName:"id" type:"string"` // 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. MinimumCompressionSize *int64 `locationName:"minimumCompressionSize" type:"integer"` // The API's name. Name *string `locationName:"name" type:"string"` // A stringified JSON policy document that applies to this RestApi regardless // of the caller and Method configuration. Policy *string `locationName:"policy" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // A version identifier for the API. Version *string `locationName:"version" type:"string"` // The warning messages reported when failonwarnings is turned on during API // import. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
Represents a REST API.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (CreateRestApiOutput) MarshalFields ¶
func (s CreateRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateRestApiOutput) String ¶
func (s CreateRestApiOutput) String() string
String returns the string representation
type CreateRestApiRequest ¶
type CreateRestApiRequest struct { *aws.Request Input *CreateRestApiInput Copy func(*CreateRestApiInput) CreateRestApiRequest }
CreateRestApiRequest is the request type for the CreateRestApi API operation.
func (CreateRestApiRequest) Send ¶
func (r CreateRestApiRequest) Send(ctx context.Context) (*CreateRestApiResponse, error)
Send marshals and sends the CreateRestApi API request.
type CreateRestApiResponse ¶
type CreateRestApiResponse struct { *CreateRestApiOutput // contains filtered or unexported fields }
CreateRestApiResponse is the response type for the CreateRestApi API operation.
func (*CreateRestApiResponse) SDKResponseMetdata ¶
func (r *CreateRestApiResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateRestApi request.
type CreateStageInput ¶
type CreateStageInput struct { // Whether cache clustering is enabled for the stage. CacheClusterEnabled *bool `locationName:"cacheClusterEnabled" type:"boolean"` // The stage's cache cluster size. CacheClusterSize CacheClusterSize `locationName:"cacheClusterSize" type:"string" enum:"true"` // The canary deployment settings of this stage. CanarySettings *CanarySettings `locationName:"canarySettings" type:"structure"` // [Required] The identifier of the Deployment resource for the Stage resource. // // DeploymentId is a required field DeploymentId *string `locationName:"deploymentId" type:"string" required:"true"` // The description of the Stage resource. Description *string `locationName:"description" type:"string"` // The version of the associated API documentation. DocumentationVersion *string `locationName:"documentationVersion" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The name for the Stage resource. Stage names can only contain // alphanumeric characters, hyphens, and underscores. Maximum length is 128 // characters. // // StageName is a required field StageName *string `locationName:"stageName" type:"string" required:"true"` // 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. Tags map[string]string `locationName:"tags" type:"map"` // Specifies whether active tracing with X-ray is enabled for the Stage. TracingEnabled *bool `locationName:"tracingEnabled" type:"boolean"` // A map that defines the stage variables for the new Stage resource. Variable // names can have alphanumeric and underscore characters, and the values must // match [A-Za-z0-9-._~:/?#&=,]+. Variables map[string]string `locationName:"variables" type:"map"` // contains filtered or unexported fields }
Requests API Gateway to create a Stage resource.
func (CreateStageInput) MarshalFields ¶
func (s CreateStageInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateStageInput) String ¶
func (s CreateStageInput) String() string
String returns the string representation
func (*CreateStageInput) Validate ¶
func (s *CreateStageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateStageOutput ¶
type CreateStageOutput struct { // Settings for logging access in this stage. AccessLogSettings *AccessLogSettings `locationName:"accessLogSettings" type:"structure"` // Specifies whether a cache cluster is enabled for the stage. CacheClusterEnabled *bool `locationName:"cacheClusterEnabled" type:"boolean"` // The size of the cache cluster for the stage, if enabled. CacheClusterSize CacheClusterSize `locationName:"cacheClusterSize" type:"string" enum:"true"` // The status of the cache cluster for the stage, if enabled. CacheClusterStatus CacheClusterStatus `locationName:"cacheClusterStatus" type:"string" enum:"true"` // Settings for the canary deployment in this stage. CanarySettings *CanarySettings `locationName:"canarySettings" type:"structure"` // The identifier of a client certificate for an API stage. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the stage was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The identifier of the Deployment that the stage points to. DeploymentId *string `locationName:"deploymentId" type:"string"` // The stage's description. Description *string `locationName:"description" type:"string"` // The version of the associated API documentation. DocumentationVersion *string `locationName:"documentationVersion" type:"string"` // The timestamp when the stage last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // A map that defines the method settings for a Stage resource. Keys (designated // as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} // for an individual method override, or /\*/\* for overriding all methods in // the stage. MethodSettings map[string]MethodSetting `locationName:"methodSettings" type:"map"` // The name of the stage is the first path segment in the Uniform Resource Identifier // (URI) of a call to API Gateway. Stage names can only contain alphanumeric // characters, hyphens, and underscores. Maximum length is 128 characters. StageName *string `locationName:"stageName" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // Specifies whether active tracing with X-ray is enabled for the Stage. TracingEnabled *bool `locationName:"tracingEnabled" type:"boolean"` // A map that defines the stage variables for a Stage resource. Variable names // can have alphanumeric and underscore characters, and the values must match // [A-Za-z0-9-._~:/?#&=,]+. Variables map[string]string `locationName:"variables" type:"map"` // The ARN of the WebAcl associated with the Stage. WebAclArn *string `locationName:"webAclArn" type:"string"` // contains filtered or unexported fields }
Represents a unique identifier for a version of a deployed RestApi that is callable by users.
Deploy an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-deploy-api.html)
func (CreateStageOutput) MarshalFields ¶
func (s CreateStageOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateStageOutput) String ¶
func (s CreateStageOutput) String() string
String returns the string representation
type CreateStageRequest ¶
type CreateStageRequest struct { *aws.Request Input *CreateStageInput Copy func(*CreateStageInput) CreateStageRequest }
CreateStageRequest is the request type for the CreateStage API operation.
func (CreateStageRequest) Send ¶
func (r CreateStageRequest) Send(ctx context.Context) (*CreateStageResponse, error)
Send marshals and sends the CreateStage API request.
type CreateStageResponse ¶
type CreateStageResponse struct { *CreateStageOutput // contains filtered or unexported fields }
CreateStageResponse is the response type for the CreateStage API operation.
func (*CreateStageResponse) SDKResponseMetdata ¶
func (r *CreateStageResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateStage request.
type CreateUsagePlanInput ¶
type CreateUsagePlanInput struct { // The associated API stages of the usage plan. ApiStages []ApiStage `locationName:"apiStages" type:"list"` // The description of the usage plan. Description *string `locationName:"description" type:"string"` // [Required] The name of the usage plan. // // Name is a required field Name *string `locationName:"name" type:"string" required:"true"` // The quota of the usage plan. Quota *QuotaSettings `locationName:"quota" type:"structure"` // 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. Tags map[string]string `locationName:"tags" type:"map"` // The throttling limits of the usage plan. Throttle *ThrottleSettings `locationName:"throttle" type:"structure"` // contains filtered or unexported fields }
The POST request to create a usage plan with the name, description, throttle limits and quota limits, as well as the associated API stages, specified in the payload.
func (CreateUsagePlanInput) MarshalFields ¶
func (s CreateUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateUsagePlanInput) String ¶
func (s CreateUsagePlanInput) String() string
String returns the string representation
func (*CreateUsagePlanInput) Validate ¶
func (s *CreateUsagePlanInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateUsagePlanKeyInput ¶
type CreateUsagePlanKeyInput struct { // [Required] The identifier of a UsagePlanKey resource for a plan customer. // // KeyId is a required field KeyId *string `locationName:"keyId" type:"string" required:"true"` // [Required] The type of a UsagePlanKey resource for a plan customer. // // KeyType is a required field KeyType *string `locationName:"keyType" type:"string" required:"true"` // [Required] The Id of the UsagePlan resource representing the usage plan containing // the to-be-created UsagePlanKey resource representing a plan customer. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The POST request to create a usage plan key for adding an existing API key to a usage plan.
func (CreateUsagePlanKeyInput) MarshalFields ¶
func (s CreateUsagePlanKeyInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateUsagePlanKeyInput) String ¶
func (s CreateUsagePlanKeyInput) String() string
String returns the string representation
func (*CreateUsagePlanKeyInput) Validate ¶
func (s *CreateUsagePlanKeyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateUsagePlanKeyOutput ¶
type CreateUsagePlanKeyOutput struct { // The Id of a usage plan key. Id *string `locationName:"id" type:"string"` // The name of a usage plan key. Name *string `locationName:"name" type:"string"` // The type of a usage plan key. Currently, the valid key type is API_KEY. Type *string `locationName:"type" type:"string"` // The value of a usage plan key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
Represents a usage plan key to identify a plan customer.
To associate an API stage with a selected API key in a usage plan, you must create a UsagePlanKey resource to represent the selected ApiKey.
" Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (CreateUsagePlanKeyOutput) MarshalFields ¶
func (s CreateUsagePlanKeyOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateUsagePlanKeyOutput) String ¶
func (s CreateUsagePlanKeyOutput) String() string
String returns the string representation
type CreateUsagePlanKeyRequest ¶
type CreateUsagePlanKeyRequest struct { *aws.Request Input *CreateUsagePlanKeyInput Copy func(*CreateUsagePlanKeyInput) CreateUsagePlanKeyRequest }
CreateUsagePlanKeyRequest is the request type for the CreateUsagePlanKey API operation.
func (CreateUsagePlanKeyRequest) Send ¶
func (r CreateUsagePlanKeyRequest) Send(ctx context.Context) (*CreateUsagePlanKeyResponse, error)
Send marshals and sends the CreateUsagePlanKey API request.
type CreateUsagePlanKeyResponse ¶
type CreateUsagePlanKeyResponse struct { *CreateUsagePlanKeyOutput // contains filtered or unexported fields }
CreateUsagePlanKeyResponse is the response type for the CreateUsagePlanKey API operation.
func (*CreateUsagePlanKeyResponse) SDKResponseMetdata ¶
func (r *CreateUsagePlanKeyResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateUsagePlanKey request.
type CreateUsagePlanOutput ¶
type CreateUsagePlanOutput struct { // The associated API stages of a usage plan. ApiStages []ApiStage `locationName:"apiStages" type:"list"` // The description of a usage plan. Description *string `locationName:"description" type:"string"` // The identifier of a UsagePlan resource. Id *string `locationName:"id" type:"string"` // The name of a usage plan. Name *string `locationName:"name" type:"string"` // The AWS Markeplace product identifier to associate with the usage plan as // a SaaS product on AWS Marketplace. ProductCode *string `locationName:"productCode" type:"string"` // The maximum number of permitted requests per a given unit time interval. Quota *QuotaSettings `locationName:"quota" type:"structure"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The request throttle limits of a usage plan. Throttle *ThrottleSettings `locationName:"throttle" type:"structure"` // contains filtered or unexported fields }
Represents a usage plan than can specify who can assess associated API stages with specified request limits and quotas.
In a usage plan, you associate an API by specifying the API's Id and a stage name of the specified API. You add plan customers by adding API keys to the plan.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (CreateUsagePlanOutput) MarshalFields ¶
func (s CreateUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateUsagePlanOutput) String ¶
func (s CreateUsagePlanOutput) String() string
String returns the string representation
type CreateUsagePlanRequest ¶
type CreateUsagePlanRequest struct { *aws.Request Input *CreateUsagePlanInput Copy func(*CreateUsagePlanInput) CreateUsagePlanRequest }
CreateUsagePlanRequest is the request type for the CreateUsagePlan API operation.
func (CreateUsagePlanRequest) Send ¶
func (r CreateUsagePlanRequest) Send(ctx context.Context) (*CreateUsagePlanResponse, error)
Send marshals and sends the CreateUsagePlan API request.
type CreateUsagePlanResponse ¶
type CreateUsagePlanResponse struct { *CreateUsagePlanOutput // contains filtered or unexported fields }
CreateUsagePlanResponse is the response type for the CreateUsagePlan API operation.
func (*CreateUsagePlanResponse) SDKResponseMetdata ¶
func (r *CreateUsagePlanResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateUsagePlan request.
type CreateVpcLinkInput ¶
type CreateVpcLinkInput struct { // The description of the VPC link. Description *string `locationName:"description" type:"string"` // [Required] The name used to label and identify the VPC link. // // Name is a required field Name *string `locationName:"name" type:"string" required:"true"` // 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. Tags map[string]string `locationName:"tags" type:"map"` // [Required] The ARNs of network load balancers of the VPC targeted by the // VPC link. The network load balancers must be owned by the same AWS account // of the API owner. // // TargetArns is a required field TargetArns []string `locationName:"targetArns" type:"list" required:"true"` // contains filtered or unexported fields }
Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.
func (CreateVpcLinkInput) MarshalFields ¶
func (s CreateVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateVpcLinkInput) String ¶
func (s CreateVpcLinkInput) String() string
String returns the string representation
func (*CreateVpcLinkInput) Validate ¶
func (s *CreateVpcLinkInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateVpcLinkOutput ¶
type CreateVpcLinkOutput struct { // The description of the VPC link. Description *string `locationName:"description" type:"string"` // The identifier of the VpcLink. It is used in an Integration to reference // this VpcLink. Id *string `locationName:"id" type:"string"` // The name used to label and identify the VPC link. Name *string `locationName:"name" type:"string"` // The status of the VPC link. The valid values are AVAILABLE, PENDING, DELETING, // or FAILED. Deploying an API will wait if the status is PENDING and will fail // if the status is DELETING. Status VpcLinkStatus `locationName:"status" type:"string" enum:"true"` // A description about the VPC link status. StatusMessage *string `locationName:"statusMessage" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The ARNs of network load balancers of the VPC targeted by the VPC link. The // network load balancers must be owned by the same AWS account of the API owner. TargetArns []string `locationName:"targetArns" type:"list"` // contains filtered or unexported fields }
A API Gateway VPC link for a RestApi to access resources in an Amazon Virtual Private Cloud (VPC).
To enable access to a resource in an Amazon Virtual Private Cloud through Amazon API Gateway, you, as an API developer, create a VpcLink resource targeted for one or more network load balancers of the VPC and then integrate an API method with a private integration that uses the VpcLink. The private integration has an integration type of HTTP or HTTP_PROXY and has a connection type of VPC_LINK. The integration uses the connectionId property to identify the VpcLink used.
func (CreateVpcLinkOutput) MarshalFields ¶
func (s CreateVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (CreateVpcLinkOutput) String ¶
func (s CreateVpcLinkOutput) String() string
String returns the string representation
type CreateVpcLinkRequest ¶
type CreateVpcLinkRequest struct { *aws.Request Input *CreateVpcLinkInput Copy func(*CreateVpcLinkInput) CreateVpcLinkRequest }
CreateVpcLinkRequest is the request type for the CreateVpcLink API operation.
func (CreateVpcLinkRequest) Send ¶
func (r CreateVpcLinkRequest) Send(ctx context.Context) (*CreateVpcLinkResponse, error)
Send marshals and sends the CreateVpcLink API request.
type CreateVpcLinkResponse ¶
type CreateVpcLinkResponse struct { *CreateVpcLinkOutput // contains filtered or unexported fields }
CreateVpcLinkResponse is the response type for the CreateVpcLink API operation.
func (*CreateVpcLinkResponse) SDKResponseMetdata ¶
func (r *CreateVpcLinkResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the CreateVpcLink request.
type DeleteApiKeyInput ¶
type DeleteApiKeyInput struct { // [Required] The identifier of the ApiKey resource to be deleted. // // ApiKey is a required field ApiKey *string `location:"uri" locationName:"api_Key" type:"string" required:"true"` // contains filtered or unexported fields }
A request to delete the ApiKey resource.
func (DeleteApiKeyInput) MarshalFields ¶
func (s DeleteApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteApiKeyInput) String ¶
func (s DeleteApiKeyInput) String() string
String returns the string representation
func (*DeleteApiKeyInput) Validate ¶
func (s *DeleteApiKeyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteApiKeyOutput ¶
type DeleteApiKeyOutput struct {
// contains filtered or unexported fields
}
func (DeleteApiKeyOutput) MarshalFields ¶
func (s DeleteApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteApiKeyOutput) String ¶
func (s DeleteApiKeyOutput) String() string
String returns the string representation
type DeleteApiKeyRequest ¶
type DeleteApiKeyRequest struct { *aws.Request Input *DeleteApiKeyInput Copy func(*DeleteApiKeyInput) DeleteApiKeyRequest }
DeleteApiKeyRequest is the request type for the DeleteApiKey API operation.
func (DeleteApiKeyRequest) Send ¶
func (r DeleteApiKeyRequest) Send(ctx context.Context) (*DeleteApiKeyResponse, error)
Send marshals and sends the DeleteApiKey API request.
type DeleteApiKeyResponse ¶
type DeleteApiKeyResponse struct { *DeleteApiKeyOutput // contains filtered or unexported fields }
DeleteApiKeyResponse is the response type for the DeleteApiKey API operation.
func (*DeleteApiKeyResponse) SDKResponseMetdata ¶
func (r *DeleteApiKeyResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteApiKey request.
type DeleteAuthorizerInput ¶
type DeleteAuthorizerInput struct { // [Required] The identifier of the Authorizer resource. // // AuthorizerId is a required field AuthorizerId *string `location:"uri" locationName:"authorizer_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to delete an existing Authorizer resource.
func (DeleteAuthorizerInput) MarshalFields ¶
func (s DeleteAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteAuthorizerInput) String ¶
func (s DeleteAuthorizerInput) String() string
String returns the string representation
func (*DeleteAuthorizerInput) Validate ¶
func (s *DeleteAuthorizerInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteAuthorizerOutput ¶
type DeleteAuthorizerOutput struct {
// contains filtered or unexported fields
}
func (DeleteAuthorizerOutput) MarshalFields ¶
func (s DeleteAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteAuthorizerOutput) String ¶
func (s DeleteAuthorizerOutput) String() string
String returns the string representation
type DeleteAuthorizerRequest ¶
type DeleteAuthorizerRequest struct { *aws.Request Input *DeleteAuthorizerInput Copy func(*DeleteAuthorizerInput) DeleteAuthorizerRequest }
DeleteAuthorizerRequest is the request type for the DeleteAuthorizer API operation.
func (DeleteAuthorizerRequest) Send ¶
func (r DeleteAuthorizerRequest) Send(ctx context.Context) (*DeleteAuthorizerResponse, error)
Send marshals and sends the DeleteAuthorizer API request.
type DeleteAuthorizerResponse ¶
type DeleteAuthorizerResponse struct { *DeleteAuthorizerOutput // contains filtered or unexported fields }
DeleteAuthorizerResponse is the response type for the DeleteAuthorizer API operation.
func (*DeleteAuthorizerResponse) SDKResponseMetdata ¶
func (r *DeleteAuthorizerResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteAuthorizer request.
type DeleteBasePathMappingInput ¶
type DeleteBasePathMappingInput struct { // [Required] The base path name of the BasePathMapping resource to delete. // // To specify an empty base path, set this parameter to '(none)'. // // BasePath is a required field BasePath *string `location:"uri" locationName:"base_path" type:"string" required:"true"` // [Required] The domain name of the BasePathMapping resource to delete. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // contains filtered or unexported fields }
A request to delete the BasePathMapping resource.
func (DeleteBasePathMappingInput) MarshalFields ¶
func (s DeleteBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteBasePathMappingInput) String ¶
func (s DeleteBasePathMappingInput) String() string
String returns the string representation
func (*DeleteBasePathMappingInput) Validate ¶
func (s *DeleteBasePathMappingInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteBasePathMappingOutput ¶
type DeleteBasePathMappingOutput struct {
// contains filtered or unexported fields
}
func (DeleteBasePathMappingOutput) MarshalFields ¶
func (s DeleteBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteBasePathMappingOutput) String ¶
func (s DeleteBasePathMappingOutput) String() string
String returns the string representation
type DeleteBasePathMappingRequest ¶
type DeleteBasePathMappingRequest struct { *aws.Request Input *DeleteBasePathMappingInput Copy func(*DeleteBasePathMappingInput) DeleteBasePathMappingRequest }
DeleteBasePathMappingRequest is the request type for the DeleteBasePathMapping API operation.
func (DeleteBasePathMappingRequest) Send ¶
func (r DeleteBasePathMappingRequest) Send(ctx context.Context) (*DeleteBasePathMappingResponse, error)
Send marshals and sends the DeleteBasePathMapping API request.
type DeleteBasePathMappingResponse ¶
type DeleteBasePathMappingResponse struct { *DeleteBasePathMappingOutput // contains filtered or unexported fields }
DeleteBasePathMappingResponse is the response type for the DeleteBasePathMapping API operation.
func (*DeleteBasePathMappingResponse) SDKResponseMetdata ¶
func (r *DeleteBasePathMappingResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteBasePathMapping request.
type DeleteClientCertificateInput ¶
type DeleteClientCertificateInput struct { // [Required] The identifier of the ClientCertificate resource to be deleted. // // ClientCertificateId is a required field ClientCertificateId *string `location:"uri" locationName:"clientcertificate_id" type:"string" required:"true"` // contains filtered or unexported fields }
A request to delete the ClientCertificate resource.
func (DeleteClientCertificateInput) MarshalFields ¶
func (s DeleteClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteClientCertificateInput) String ¶
func (s DeleteClientCertificateInput) String() string
String returns the string representation
func (*DeleteClientCertificateInput) Validate ¶
func (s *DeleteClientCertificateInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteClientCertificateOutput ¶
type DeleteClientCertificateOutput struct {
// contains filtered or unexported fields
}
func (DeleteClientCertificateOutput) MarshalFields ¶
func (s DeleteClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteClientCertificateOutput) String ¶
func (s DeleteClientCertificateOutput) String() string
String returns the string representation
type DeleteClientCertificateRequest ¶
type DeleteClientCertificateRequest struct { *aws.Request Input *DeleteClientCertificateInput Copy func(*DeleteClientCertificateInput) DeleteClientCertificateRequest }
DeleteClientCertificateRequest is the request type for the DeleteClientCertificate API operation.
func (DeleteClientCertificateRequest) Send ¶
func (r DeleteClientCertificateRequest) Send(ctx context.Context) (*DeleteClientCertificateResponse, error)
Send marshals and sends the DeleteClientCertificate API request.
type DeleteClientCertificateResponse ¶
type DeleteClientCertificateResponse struct { *DeleteClientCertificateOutput // contains filtered or unexported fields }
DeleteClientCertificateResponse is the response type for the DeleteClientCertificate API operation.
func (*DeleteClientCertificateResponse) SDKResponseMetdata ¶
func (r *DeleteClientCertificateResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteClientCertificate request.
type DeleteDeploymentInput ¶
type DeleteDeploymentInput struct { // [Required] The identifier of the Deployment resource to delete. // // DeploymentId is a required field DeploymentId *string `location:"uri" locationName:"deployment_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to delete a Deployment resource.
func (DeleteDeploymentInput) MarshalFields ¶
func (s DeleteDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDeploymentInput) String ¶
func (s DeleteDeploymentInput) String() string
String returns the string representation
func (*DeleteDeploymentInput) Validate ¶
func (s *DeleteDeploymentInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteDeploymentOutput ¶
type DeleteDeploymentOutput struct {
// contains filtered or unexported fields
}
func (DeleteDeploymentOutput) MarshalFields ¶
func (s DeleteDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDeploymentOutput) String ¶
func (s DeleteDeploymentOutput) String() string
String returns the string representation
type DeleteDeploymentRequest ¶
type DeleteDeploymentRequest struct { *aws.Request Input *DeleteDeploymentInput Copy func(*DeleteDeploymentInput) DeleteDeploymentRequest }
DeleteDeploymentRequest is the request type for the DeleteDeployment API operation.
func (DeleteDeploymentRequest) Send ¶
func (r DeleteDeploymentRequest) Send(ctx context.Context) (*DeleteDeploymentResponse, error)
Send marshals and sends the DeleteDeployment API request.
type DeleteDeploymentResponse ¶
type DeleteDeploymentResponse struct { *DeleteDeploymentOutput // contains filtered or unexported fields }
DeleteDeploymentResponse is the response type for the DeleteDeployment API operation.
func (*DeleteDeploymentResponse) SDKResponseMetdata ¶
func (r *DeleteDeploymentResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteDeployment request.
type DeleteDocumentationPartInput ¶
type DeleteDocumentationPartInput struct { // [Required] The identifier of the to-be-deleted documentation part. // // DocumentationPartId is a required field DocumentationPartId *string `location:"uri" locationName:"part_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Deletes an existing documentation part of an API.
func (DeleteDocumentationPartInput) MarshalFields ¶
func (s DeleteDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDocumentationPartInput) String ¶
func (s DeleteDocumentationPartInput) String() string
String returns the string representation
func (*DeleteDocumentationPartInput) Validate ¶
func (s *DeleteDocumentationPartInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteDocumentationPartOutput ¶
type DeleteDocumentationPartOutput struct {
// contains filtered or unexported fields
}
func (DeleteDocumentationPartOutput) MarshalFields ¶
func (s DeleteDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDocumentationPartOutput) String ¶
func (s DeleteDocumentationPartOutput) String() string
String returns the string representation
type DeleteDocumentationPartRequest ¶
type DeleteDocumentationPartRequest struct { *aws.Request Input *DeleteDocumentationPartInput Copy func(*DeleteDocumentationPartInput) DeleteDocumentationPartRequest }
DeleteDocumentationPartRequest is the request type for the DeleteDocumentationPart API operation.
func (DeleteDocumentationPartRequest) Send ¶
func (r DeleteDocumentationPartRequest) Send(ctx context.Context) (*DeleteDocumentationPartResponse, error)
Send marshals and sends the DeleteDocumentationPart API request.
type DeleteDocumentationPartResponse ¶
type DeleteDocumentationPartResponse struct { *DeleteDocumentationPartOutput // contains filtered or unexported fields }
DeleteDocumentationPartResponse is the response type for the DeleteDocumentationPart API operation.
func (*DeleteDocumentationPartResponse) SDKResponseMetdata ¶
func (r *DeleteDocumentationPartResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteDocumentationPart request.
type DeleteDocumentationVersionInput ¶
type DeleteDocumentationVersionInput struct { // [Required] The version identifier of a to-be-deleted documentation snapshot. // // DocumentationVersion is a required field DocumentationVersion *string `location:"uri" locationName:"doc_version" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Deletes an existing documentation version of an API.
func (DeleteDocumentationVersionInput) MarshalFields ¶
func (s DeleteDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDocumentationVersionInput) String ¶
func (s DeleteDocumentationVersionInput) String() string
String returns the string representation
func (*DeleteDocumentationVersionInput) Validate ¶
func (s *DeleteDocumentationVersionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteDocumentationVersionOutput ¶
type DeleteDocumentationVersionOutput struct {
// contains filtered or unexported fields
}
func (DeleteDocumentationVersionOutput) MarshalFields ¶
func (s DeleteDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDocumentationVersionOutput) String ¶
func (s DeleteDocumentationVersionOutput) String() string
String returns the string representation
type DeleteDocumentationVersionRequest ¶
type DeleteDocumentationVersionRequest struct { *aws.Request Input *DeleteDocumentationVersionInput Copy func(*DeleteDocumentationVersionInput) DeleteDocumentationVersionRequest }
DeleteDocumentationVersionRequest is the request type for the DeleteDocumentationVersion API operation.
func (DeleteDocumentationVersionRequest) Send ¶
func (r DeleteDocumentationVersionRequest) Send(ctx context.Context) (*DeleteDocumentationVersionResponse, error)
Send marshals and sends the DeleteDocumentationVersion API request.
type DeleteDocumentationVersionResponse ¶
type DeleteDocumentationVersionResponse struct { *DeleteDocumentationVersionOutput // contains filtered or unexported fields }
DeleteDocumentationVersionResponse is the response type for the DeleteDocumentationVersion API operation.
func (*DeleteDocumentationVersionResponse) SDKResponseMetdata ¶
func (r *DeleteDocumentationVersionResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteDocumentationVersion request.
type DeleteDomainNameInput ¶
type DeleteDomainNameInput struct { // [Required] The name of the DomainName resource to be deleted. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // contains filtered or unexported fields }
A request to delete the DomainName resource.
func (DeleteDomainNameInput) MarshalFields ¶
func (s DeleteDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDomainNameInput) String ¶
func (s DeleteDomainNameInput) String() string
String returns the string representation
func (*DeleteDomainNameInput) Validate ¶
func (s *DeleteDomainNameInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteDomainNameOutput ¶
type DeleteDomainNameOutput struct {
// contains filtered or unexported fields
}
func (DeleteDomainNameOutput) MarshalFields ¶
func (s DeleteDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteDomainNameOutput) String ¶
func (s DeleteDomainNameOutput) String() string
String returns the string representation
type DeleteDomainNameRequest ¶
type DeleteDomainNameRequest struct { *aws.Request Input *DeleteDomainNameInput Copy func(*DeleteDomainNameInput) DeleteDomainNameRequest }
DeleteDomainNameRequest is the request type for the DeleteDomainName API operation.
func (DeleteDomainNameRequest) Send ¶
func (r DeleteDomainNameRequest) Send(ctx context.Context) (*DeleteDomainNameResponse, error)
Send marshals and sends the DeleteDomainName API request.
type DeleteDomainNameResponse ¶
type DeleteDomainNameResponse struct { *DeleteDomainNameOutput // contains filtered or unexported fields }
DeleteDomainNameResponse is the response type for the DeleteDomainName API operation.
func (*DeleteDomainNameResponse) SDKResponseMetdata ¶
func (r *DeleteDomainNameResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteDomainName request.
type DeleteGatewayResponseInput ¶
type DeleteGatewayResponseInput struct { // [Required] // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE // // ResponseType is a required field ResponseType GatewayResponseType `location:"uri" locationName:"response_type" type:"string" required:"true" enum:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.
func (DeleteGatewayResponseInput) MarshalFields ¶
func (s DeleteGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteGatewayResponseInput) String ¶
func (s DeleteGatewayResponseInput) String() string
String returns the string representation
func (*DeleteGatewayResponseInput) Validate ¶
func (s *DeleteGatewayResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteGatewayResponseOutput ¶
type DeleteGatewayResponseOutput struct {
// contains filtered or unexported fields
}
func (DeleteGatewayResponseOutput) MarshalFields ¶
func (s DeleteGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteGatewayResponseOutput) String ¶
func (s DeleteGatewayResponseOutput) String() string
String returns the string representation
type DeleteGatewayResponseRequest ¶
type DeleteGatewayResponseRequest struct { *aws.Request Input *DeleteGatewayResponseInput Copy func(*DeleteGatewayResponseInput) DeleteGatewayResponseRequest }
DeleteGatewayResponseRequest is the request type for the DeleteGatewayResponse API operation.
func (DeleteGatewayResponseRequest) Send ¶
func (r DeleteGatewayResponseRequest) Send(ctx context.Context) (*DeleteGatewayResponseResponse, error)
Send marshals and sends the DeleteGatewayResponse API request.
type DeleteGatewayResponseResponse ¶
type DeleteGatewayResponseResponse struct { *DeleteGatewayResponseOutput // contains filtered or unexported fields }
DeleteGatewayResponseResponse is the response type for the DeleteGatewayResponse API operation.
func (*DeleteGatewayResponseResponse) SDKResponseMetdata ¶
func (r *DeleteGatewayResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteGatewayResponse request.
type DeleteIntegrationInput ¶
type DeleteIntegrationInput struct { // [Required] Specifies a delete integration request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] Specifies a delete integration request's resource identifier. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Represents a delete integration request.
func (DeleteIntegrationInput) MarshalFields ¶
func (s DeleteIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteIntegrationInput) String ¶
func (s DeleteIntegrationInput) String() string
String returns the string representation
func (*DeleteIntegrationInput) Validate ¶
func (s *DeleteIntegrationInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteIntegrationOutput ¶
type DeleteIntegrationOutput struct {
// contains filtered or unexported fields
}
func (DeleteIntegrationOutput) MarshalFields ¶
func (s DeleteIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteIntegrationOutput) String ¶
func (s DeleteIntegrationOutput) String() string
String returns the string representation
type DeleteIntegrationRequest ¶
type DeleteIntegrationRequest struct { *aws.Request Input *DeleteIntegrationInput Copy func(*DeleteIntegrationInput) DeleteIntegrationRequest }
DeleteIntegrationRequest is the request type for the DeleteIntegration API operation.
func (DeleteIntegrationRequest) Send ¶
func (r DeleteIntegrationRequest) Send(ctx context.Context) (*DeleteIntegrationResponse, error)
Send marshals and sends the DeleteIntegration API request.
type DeleteIntegrationResponse ¶
type DeleteIntegrationResponse struct { *DeleteIntegrationOutput // contains filtered or unexported fields }
DeleteIntegrationResponse is the response type for the DeleteIntegration API operation.
func (*DeleteIntegrationResponse) SDKResponseMetdata ¶
func (r *DeleteIntegrationResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteIntegration request.
type DeleteIntegrationResponseInput ¶
type DeleteIntegrationResponseInput struct { // [Required] Specifies a delete integration response request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] Specifies a delete integration response request's resource identifier. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] Specifies a delete integration response request's status code. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
Represents a delete integration response request.
func (DeleteIntegrationResponseInput) MarshalFields ¶
func (s DeleteIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteIntegrationResponseInput) String ¶
func (s DeleteIntegrationResponseInput) String() string
String returns the string representation
func (*DeleteIntegrationResponseInput) Validate ¶
func (s *DeleteIntegrationResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteIntegrationResponseOutput ¶
type DeleteIntegrationResponseOutput struct {
// contains filtered or unexported fields
}
func (DeleteIntegrationResponseOutput) MarshalFields ¶
func (s DeleteIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteIntegrationResponseOutput) String ¶
func (s DeleteIntegrationResponseOutput) String() string
String returns the string representation
type DeleteIntegrationResponseRequest ¶
type DeleteIntegrationResponseRequest struct { *aws.Request Input *DeleteIntegrationResponseInput Copy func(*DeleteIntegrationResponseInput) DeleteIntegrationResponseRequest }
DeleteIntegrationResponseRequest is the request type for the DeleteIntegrationResponse API operation.
func (DeleteIntegrationResponseRequest) Send ¶
func (r DeleteIntegrationResponseRequest) Send(ctx context.Context) (*DeleteIntegrationResponseResponse, error)
Send marshals and sends the DeleteIntegrationResponse API request.
type DeleteIntegrationResponseResponse ¶
type DeleteIntegrationResponseResponse struct { *DeleteIntegrationResponseOutput // contains filtered or unexported fields }
DeleteIntegrationResponseResponse is the response type for the DeleteIntegrationResponse API operation.
func (*DeleteIntegrationResponseResponse) SDKResponseMetdata ¶
func (r *DeleteIntegrationResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteIntegrationResponse request.
type DeleteMethodInput ¶
type DeleteMethodInput struct { // [Required] The HTTP verb of the Method resource. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] The Resource identifier for the Method resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to delete an existing Method resource.
func (DeleteMethodInput) MarshalFields ¶
func (s DeleteMethodInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteMethodInput) String ¶
func (s DeleteMethodInput) String() string
String returns the string representation
func (*DeleteMethodInput) Validate ¶
func (s *DeleteMethodInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteMethodOutput ¶
type DeleteMethodOutput struct {
// contains filtered or unexported fields
}
func (DeleteMethodOutput) MarshalFields ¶
func (s DeleteMethodOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteMethodOutput) String ¶
func (s DeleteMethodOutput) String() string
String returns the string representation
type DeleteMethodRequest ¶
type DeleteMethodRequest struct { *aws.Request Input *DeleteMethodInput Copy func(*DeleteMethodInput) DeleteMethodRequest }
DeleteMethodRequest is the request type for the DeleteMethod API operation.
func (DeleteMethodRequest) Send ¶
func (r DeleteMethodRequest) Send(ctx context.Context) (*DeleteMethodResponse, error)
Send marshals and sends the DeleteMethod API request.
type DeleteMethodResponse ¶
type DeleteMethodResponse struct { *DeleteMethodOutput // contains filtered or unexported fields }
DeleteMethodResponse is the response type for the DeleteMethod API operation.
func (*DeleteMethodResponse) SDKResponseMetdata ¶
func (r *DeleteMethodResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteMethod request.
type DeleteMethodResponseInput ¶
type DeleteMethodResponseInput struct { // [Required] The HTTP verb of the Method resource. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] The Resource identifier for the MethodResponse resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The status code identifier for the MethodResponse resource. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
A request to delete an existing MethodResponse resource.
func (DeleteMethodResponseInput) MarshalFields ¶
func (s DeleteMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteMethodResponseInput) String ¶
func (s DeleteMethodResponseInput) String() string
String returns the string representation
func (*DeleteMethodResponseInput) Validate ¶
func (s *DeleteMethodResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteMethodResponseOutput ¶
type DeleteMethodResponseOutput struct {
// contains filtered or unexported fields
}
func (DeleteMethodResponseOutput) MarshalFields ¶
func (s DeleteMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteMethodResponseOutput) String ¶
func (s DeleteMethodResponseOutput) String() string
String returns the string representation
type DeleteMethodResponseRequest ¶
type DeleteMethodResponseRequest struct { *aws.Request Input *DeleteMethodResponseInput Copy func(*DeleteMethodResponseInput) DeleteMethodResponseRequest }
DeleteMethodResponseRequest is the request type for the DeleteMethodResponse API operation.
func (DeleteMethodResponseRequest) Send ¶
func (r DeleteMethodResponseRequest) Send(ctx context.Context) (*DeleteMethodResponseResponse, error)
Send marshals and sends the DeleteMethodResponse API request.
type DeleteMethodResponseResponse ¶
type DeleteMethodResponseResponse struct { *DeleteMethodResponseOutput // contains filtered or unexported fields }
DeleteMethodResponseResponse is the response type for the DeleteMethodResponse API operation.
func (*DeleteMethodResponseResponse) SDKResponseMetdata ¶
func (r *DeleteMethodResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteMethodResponse request.
type DeleteModelInput ¶
type DeleteModelInput struct { // [Required] The name of the model to delete. // // ModelName is a required field ModelName *string `location:"uri" locationName:"model_name" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to delete an existing model in an existing RestApi resource.
func (DeleteModelInput) MarshalFields ¶
func (s DeleteModelInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteModelInput) String ¶
func (s DeleteModelInput) String() string
String returns the string representation
func (*DeleteModelInput) Validate ¶
func (s *DeleteModelInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteModelOutput ¶
type DeleteModelOutput struct {
// contains filtered or unexported fields
}
func (DeleteModelOutput) MarshalFields ¶
func (s DeleteModelOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteModelOutput) String ¶
func (s DeleteModelOutput) String() string
String returns the string representation
type DeleteModelRequest ¶
type DeleteModelRequest struct { *aws.Request Input *DeleteModelInput Copy func(*DeleteModelInput) DeleteModelRequest }
DeleteModelRequest is the request type for the DeleteModel API operation.
func (DeleteModelRequest) Send ¶
func (r DeleteModelRequest) Send(ctx context.Context) (*DeleteModelResponse, error)
Send marshals and sends the DeleteModel API request.
type DeleteModelResponse ¶
type DeleteModelResponse struct { *DeleteModelOutput // contains filtered or unexported fields }
DeleteModelResponse is the response type for the DeleteModel API operation.
func (*DeleteModelResponse) SDKResponseMetdata ¶
func (r *DeleteModelResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteModel request.
type DeleteRequestValidatorInput ¶
type DeleteRequestValidatorInput struct { // [Required] The identifier of the RequestValidator to be deleted. // // RequestValidatorId is a required field RequestValidatorId *string `location:"uri" locationName:"requestvalidator_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Deletes a specified RequestValidator of a given RestApi.
func (DeleteRequestValidatorInput) MarshalFields ¶
func (s DeleteRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteRequestValidatorInput) String ¶
func (s DeleteRequestValidatorInput) String() string
String returns the string representation
func (*DeleteRequestValidatorInput) Validate ¶
func (s *DeleteRequestValidatorInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteRequestValidatorOutput ¶
type DeleteRequestValidatorOutput struct {
// contains filtered or unexported fields
}
func (DeleteRequestValidatorOutput) MarshalFields ¶
func (s DeleteRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteRequestValidatorOutput) String ¶
func (s DeleteRequestValidatorOutput) String() string
String returns the string representation
type DeleteRequestValidatorRequest ¶
type DeleteRequestValidatorRequest struct { *aws.Request Input *DeleteRequestValidatorInput Copy func(*DeleteRequestValidatorInput) DeleteRequestValidatorRequest }
DeleteRequestValidatorRequest is the request type for the DeleteRequestValidator API operation.
func (DeleteRequestValidatorRequest) Send ¶
func (r DeleteRequestValidatorRequest) Send(ctx context.Context) (*DeleteRequestValidatorResponse, error)
Send marshals and sends the DeleteRequestValidator API request.
type DeleteRequestValidatorResponse ¶
type DeleteRequestValidatorResponse struct { *DeleteRequestValidatorOutput // contains filtered or unexported fields }
DeleteRequestValidatorResponse is the response type for the DeleteRequestValidator API operation.
func (*DeleteRequestValidatorResponse) SDKResponseMetdata ¶
func (r *DeleteRequestValidatorResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteRequestValidator request.
type DeleteResourceInput ¶
type DeleteResourceInput struct { // [Required] The identifier of the Resource resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to delete a Resource.
func (DeleteResourceInput) MarshalFields ¶
func (s DeleteResourceInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteResourceInput) String ¶
func (s DeleteResourceInput) String() string
String returns the string representation
func (*DeleteResourceInput) Validate ¶
func (s *DeleteResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteResourceOutput ¶
type DeleteResourceOutput struct {
// contains filtered or unexported fields
}
func (DeleteResourceOutput) MarshalFields ¶
func (s DeleteResourceOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteResourceOutput) String ¶
func (s DeleteResourceOutput) String() string
String returns the string representation
type DeleteResourceRequest ¶
type DeleteResourceRequest struct { *aws.Request Input *DeleteResourceInput Copy func(*DeleteResourceInput) DeleteResourceRequest }
DeleteResourceRequest is the request type for the DeleteResource API operation.
func (DeleteResourceRequest) Send ¶
func (r DeleteResourceRequest) Send(ctx context.Context) (*DeleteResourceResponse, error)
Send marshals and sends the DeleteResource API request.
type DeleteResourceResponse ¶
type DeleteResourceResponse struct { *DeleteResourceOutput // contains filtered or unexported fields }
DeleteResourceResponse is the response type for the DeleteResource API operation.
func (*DeleteResourceResponse) SDKResponseMetdata ¶
func (r *DeleteResourceResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteResource request.
type DeleteRestApiInput ¶
type DeleteRestApiInput struct { // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to delete the specified API from your collection.
func (DeleteRestApiInput) MarshalFields ¶
func (s DeleteRestApiInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteRestApiInput) String ¶
func (s DeleteRestApiInput) String() string
String returns the string representation
func (*DeleteRestApiInput) Validate ¶
func (s *DeleteRestApiInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteRestApiOutput ¶
type DeleteRestApiOutput struct {
// contains filtered or unexported fields
}
func (DeleteRestApiOutput) MarshalFields ¶
func (s DeleteRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteRestApiOutput) String ¶
func (s DeleteRestApiOutput) String() string
String returns the string representation
type DeleteRestApiRequest ¶
type DeleteRestApiRequest struct { *aws.Request Input *DeleteRestApiInput Copy func(*DeleteRestApiInput) DeleteRestApiRequest }
DeleteRestApiRequest is the request type for the DeleteRestApi API operation.
func (DeleteRestApiRequest) Send ¶
func (r DeleteRestApiRequest) Send(ctx context.Context) (*DeleteRestApiResponse, error)
Send marshals and sends the DeleteRestApi API request.
type DeleteRestApiResponse ¶
type DeleteRestApiResponse struct { *DeleteRestApiOutput // contains filtered or unexported fields }
DeleteRestApiResponse is the response type for the DeleteRestApi API operation.
func (*DeleteRestApiResponse) SDKResponseMetdata ¶
func (r *DeleteRestApiResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteRestApi request.
type DeleteStageInput ¶
type DeleteStageInput struct { // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The name of the Stage resource to delete. // // StageName is a required field StageName *string `location:"uri" locationName:"stage_name" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to delete a Stage resource.
func (DeleteStageInput) MarshalFields ¶
func (s DeleteStageInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteStageInput) String ¶
func (s DeleteStageInput) String() string
String returns the string representation
func (*DeleteStageInput) Validate ¶
func (s *DeleteStageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteStageOutput ¶
type DeleteStageOutput struct {
// contains filtered or unexported fields
}
func (DeleteStageOutput) MarshalFields ¶
func (s DeleteStageOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteStageOutput) String ¶
func (s DeleteStageOutput) String() string
String returns the string representation
type DeleteStageRequest ¶
type DeleteStageRequest struct { *aws.Request Input *DeleteStageInput Copy func(*DeleteStageInput) DeleteStageRequest }
DeleteStageRequest is the request type for the DeleteStage API operation.
func (DeleteStageRequest) Send ¶
func (r DeleteStageRequest) Send(ctx context.Context) (*DeleteStageResponse, error)
Send marshals and sends the DeleteStage API request.
type DeleteStageResponse ¶
type DeleteStageResponse struct { *DeleteStageOutput // contains filtered or unexported fields }
DeleteStageResponse is the response type for the DeleteStage API operation.
func (*DeleteStageResponse) SDKResponseMetdata ¶
func (r *DeleteStageResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteStage request.
type DeleteUsagePlanInput ¶
type DeleteUsagePlanInput struct { // [Required] The Id of the to-be-deleted usage plan. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The DELETE request to delete a usage plan of a given plan Id.
func (DeleteUsagePlanInput) MarshalFields ¶
func (s DeleteUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteUsagePlanInput) String ¶
func (s DeleteUsagePlanInput) String() string
String returns the string representation
func (*DeleteUsagePlanInput) Validate ¶
func (s *DeleteUsagePlanInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteUsagePlanKeyInput ¶
type DeleteUsagePlanKeyInput struct { // [Required] The Id of the UsagePlanKey resource to be deleted. // // KeyId is a required field KeyId *string `location:"uri" locationName:"keyId" type:"string" required:"true"` // [Required] The Id of the UsagePlan resource representing the usage plan containing // the to-be-deleted UsagePlanKey resource representing a plan customer. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The DELETE request to delete a usage plan key and remove the underlying API key from the associated usage plan.
func (DeleteUsagePlanKeyInput) MarshalFields ¶
func (s DeleteUsagePlanKeyInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteUsagePlanKeyInput) String ¶
func (s DeleteUsagePlanKeyInput) String() string
String returns the string representation
func (*DeleteUsagePlanKeyInput) Validate ¶
func (s *DeleteUsagePlanKeyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteUsagePlanKeyOutput ¶
type DeleteUsagePlanKeyOutput struct {
// contains filtered or unexported fields
}
func (DeleteUsagePlanKeyOutput) MarshalFields ¶
func (s DeleteUsagePlanKeyOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteUsagePlanKeyOutput) String ¶
func (s DeleteUsagePlanKeyOutput) String() string
String returns the string representation
type DeleteUsagePlanKeyRequest ¶
type DeleteUsagePlanKeyRequest struct { *aws.Request Input *DeleteUsagePlanKeyInput Copy func(*DeleteUsagePlanKeyInput) DeleteUsagePlanKeyRequest }
DeleteUsagePlanKeyRequest is the request type for the DeleteUsagePlanKey API operation.
func (DeleteUsagePlanKeyRequest) Send ¶
func (r DeleteUsagePlanKeyRequest) Send(ctx context.Context) (*DeleteUsagePlanKeyResponse, error)
Send marshals and sends the DeleteUsagePlanKey API request.
type DeleteUsagePlanKeyResponse ¶
type DeleteUsagePlanKeyResponse struct { *DeleteUsagePlanKeyOutput // contains filtered or unexported fields }
DeleteUsagePlanKeyResponse is the response type for the DeleteUsagePlanKey API operation.
func (*DeleteUsagePlanKeyResponse) SDKResponseMetdata ¶
func (r *DeleteUsagePlanKeyResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteUsagePlanKey request.
type DeleteUsagePlanOutput ¶
type DeleteUsagePlanOutput struct {
// contains filtered or unexported fields
}
func (DeleteUsagePlanOutput) MarshalFields ¶
func (s DeleteUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteUsagePlanOutput) String ¶
func (s DeleteUsagePlanOutput) String() string
String returns the string representation
type DeleteUsagePlanRequest ¶
type DeleteUsagePlanRequest struct { *aws.Request Input *DeleteUsagePlanInput Copy func(*DeleteUsagePlanInput) DeleteUsagePlanRequest }
DeleteUsagePlanRequest is the request type for the DeleteUsagePlan API operation.
func (DeleteUsagePlanRequest) Send ¶
func (r DeleteUsagePlanRequest) Send(ctx context.Context) (*DeleteUsagePlanResponse, error)
Send marshals and sends the DeleteUsagePlan API request.
type DeleteUsagePlanResponse ¶
type DeleteUsagePlanResponse struct { *DeleteUsagePlanOutput // contains filtered or unexported fields }
DeleteUsagePlanResponse is the response type for the DeleteUsagePlan API operation.
func (*DeleteUsagePlanResponse) SDKResponseMetdata ¶
func (r *DeleteUsagePlanResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteUsagePlan request.
type DeleteVpcLinkInput ¶
type DeleteVpcLinkInput struct { // [Required] The identifier of the VpcLink. It is used in an Integration to // reference this VpcLink. // // VpcLinkId is a required field VpcLinkId *string `location:"uri" locationName:"vpclink_id" type:"string" required:"true"` // contains filtered or unexported fields }
Deletes an existing VpcLink of a specified identifier.
func (DeleteVpcLinkInput) MarshalFields ¶
func (s DeleteVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteVpcLinkInput) String ¶
func (s DeleteVpcLinkInput) String() string
String returns the string representation
func (*DeleteVpcLinkInput) Validate ¶
func (s *DeleteVpcLinkInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteVpcLinkOutput ¶
type DeleteVpcLinkOutput struct {
// contains filtered or unexported fields
}
func (DeleteVpcLinkOutput) MarshalFields ¶
func (s DeleteVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeleteVpcLinkOutput) String ¶
func (s DeleteVpcLinkOutput) String() string
String returns the string representation
type DeleteVpcLinkRequest ¶
type DeleteVpcLinkRequest struct { *aws.Request Input *DeleteVpcLinkInput Copy func(*DeleteVpcLinkInput) DeleteVpcLinkRequest }
DeleteVpcLinkRequest is the request type for the DeleteVpcLink API operation.
func (DeleteVpcLinkRequest) Send ¶
func (r DeleteVpcLinkRequest) Send(ctx context.Context) (*DeleteVpcLinkResponse, error)
Send marshals and sends the DeleteVpcLink API request.
type DeleteVpcLinkResponse ¶
type DeleteVpcLinkResponse struct { *DeleteVpcLinkOutput // contains filtered or unexported fields }
DeleteVpcLinkResponse is the response type for the DeleteVpcLink API operation.
func (*DeleteVpcLinkResponse) SDKResponseMetdata ¶
func (r *DeleteVpcLinkResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the DeleteVpcLink request.
type Deployment ¶
type Deployment struct { // A summary of the RestApi at the date and time that the deployment resource // was created. ApiSummary map[string]map[string]MethodSnapshot `locationName:"apiSummary" type:"map"` // The date and time that the deployment resource was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description for the deployment resource. Description *string `locationName:"description" type:"string"` // The identifier for the deployment resource. Id *string `locationName:"id" type:"string"` // contains filtered or unexported fields }
An immutable representation of a RestApi resource that can be called by users using Stages. A deployment must be associated with a Stage for it to be callable over the Internet.
To create a deployment, call POST on the Deployments resource of a RestApi. To view, update, or delete a deployment, call GET, PATCH, or DELETE on the specified deployment resource (/restapis/{restapi_id}/deployments/{deployment_id}).
RestApi, Deployments, Stage, AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-deployment.html), AWS SDKs (https://aws.amazon.com/tools/)
func (Deployment) MarshalFields ¶
func (s Deployment) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Deployment) String ¶
func (s Deployment) String() string
String returns the string representation
type DeploymentCanarySettings ¶
type DeploymentCanarySettings struct { // The percentage (0.0-100.0) of traffic routed to the canary deployment. PercentTraffic *float64 `locationName:"percentTraffic" type:"double"` // A stage variable overrides used for the canary release deployment. They can // override existing stage variables or add new stage variables for the canary // release deployment. These stage variables are represented as a string-to-string // map between stage variable names and their values. StageVariableOverrides map[string]string `locationName:"stageVariableOverrides" type:"map"` // A Boolean flag to indicate whether the canary release deployment uses the // stage cache or not. UseStageCache *bool `locationName:"useStageCache" type:"boolean"` // contains filtered or unexported fields }
The input configuration for a canary deployment.
func (DeploymentCanarySettings) MarshalFields ¶
func (s DeploymentCanarySettings) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DeploymentCanarySettings) String ¶
func (s DeploymentCanarySettings) String() string
String returns the string representation
type DocumentationPart ¶
type DocumentationPart struct { // The DocumentationPart identifier, generated by API Gateway when the DocumentationPart // is created. Id *string `locationName:"id" type:"string"` // The location of the API entity to which the documentation applies. Valid // fields depend on the targeted API entity type. All the valid location fields // are not required. If not explicitly specified, a valid location field is // treated as a wildcard and associated documentation content may be inherited // by matching entities, unless overridden. Location *DocumentationPartLocation `locationName:"location" type:"structure"` // 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 OpenAPI-compliant documentation-related fields // from the properties map are exported and, hence, published as part of the // API entity definitions, while the original documentation parts are exported // in a OpenAPI extension of x-amazon-apigateway-documentation. Properties *string `locationName:"properties" type:"string"` // contains filtered or unexported fields }
A documentation part for a targeted API entity.
A documentation part consists of a content map (properties) and a target (location). The target specifies an API entity to which the documentation content applies. The supported API entity types are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Valid location fields depend on the API entity type. All valid fields are not required.
The content map is a JSON string of API-specific key-value pairs. Although an API can use any shape for the content map, only the OpenAPI-compliant documentation fields will be injected into the associated API entity definition in the exported OpenAPI definition file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationParts
func (DocumentationPart) MarshalFields ¶
func (s DocumentationPart) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DocumentationPart) String ¶
func (s DocumentationPart) String() string
String returns the string representation
type DocumentationPartLocation ¶
type DocumentationPartLocation struct { // 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. Method *string `locationName:"method" type:"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. Name *string `locationName:"name" type:"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. Path *string `locationName:"path" type:"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. StatusCode *string `locationName:"statusCode" type:"string"` // [Required] 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. // // Type is a required field Type DocumentationPartType `locationName:"type" type:"string" required:"true" enum:"true"` // contains filtered or unexported fields }
Specifies the target API entity to which the documentation applies.
func (DocumentationPartLocation) MarshalFields ¶
func (s DocumentationPartLocation) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DocumentationPartLocation) String ¶
func (s DocumentationPartLocation) String() string
String returns the string representation
func (*DocumentationPartLocation) Validate ¶
func (s *DocumentationPartLocation) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DocumentationPartType ¶
type DocumentationPartType string
const ( DocumentationPartTypeApi DocumentationPartType = "API" DocumentationPartTypeAuthorizer DocumentationPartType = "AUTHORIZER" DocumentationPartTypeModel DocumentationPartType = "MODEL" DocumentationPartTypeResource DocumentationPartType = "RESOURCE" DocumentationPartTypeMethod DocumentationPartType = "METHOD" DocumentationPartTypePathParameter DocumentationPartType = "PATH_PARAMETER" DocumentationPartTypeQueryParameter DocumentationPartType = "QUERY_PARAMETER" DocumentationPartTypeRequestHeader DocumentationPartType = "REQUEST_HEADER" DocumentationPartTypeRequestBody DocumentationPartType = "REQUEST_BODY" DocumentationPartTypeResponse DocumentationPartType = "RESPONSE" DocumentationPartTypeResponseHeader DocumentationPartType = "RESPONSE_HEADER" DocumentationPartTypeResponseBody DocumentationPartType = "RESPONSE_BODY" )
Enum values for DocumentationPartType
func (DocumentationPartType) MarshalValue ¶
func (enum DocumentationPartType) MarshalValue() (string, error)
func (DocumentationPartType) MarshalValueBuf ¶
func (enum DocumentationPartType) MarshalValueBuf(b []byte) ([]byte, error)
type DocumentationVersion ¶
type DocumentationVersion struct { // The date when the API documentation snapshot is created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the API documentation snapshot. Description *string `locationName:"description" type:"string"` // The version identifier of the API documentation snapshot. Version *string `locationName:"version" type:"string"` // contains filtered or unexported fields }
A snapshot of the documentation of an API.
Publishing API documentation involves creating a documentation version associated with an API stage and exporting the versioned documentation to an external (e.g., OpenAPI) file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationPart, DocumentationVersions
func (DocumentationVersion) MarshalFields ¶
func (s DocumentationVersion) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DocumentationVersion) String ¶
func (s DocumentationVersion) String() string
String returns the string representation
type DomainName ¶
type DomainName struct { // The reference to an AWS-managed certificate that will be used by edge-optimized // endpoint for this domain name. AWS Certificate Manager is the only supported // source. CertificateArn *string `locationName:"certificateArn" type:"string"` // The name of the certificate that will be used by edge-optimized endpoint // for this domain name. CertificateName *string `locationName:"certificateName" type:"string"` // The timestamp when the certificate that was used by edge-optimized endpoint // for this domain name was uploaded. CertificateUploadDate *time.Time `locationName:"certificateUploadDate" type:"timestamp"` // The domain name of the Amazon CloudFront distribution associated with this // custom domain name for an edge-optimized endpoint. You set up this association // when adding a DNS record pointing the custom domain name to this distribution // name. For more information about CloudFront distributions, see the Amazon // CloudFront documentation (https://aws.amazon.com/documentation/cloudfront/). DistributionDomainName *string `locationName:"distributionDomainName" type:"string"` // The region-agnostic Amazon Route 53 Hosted Zone ID of the edge-optimized // endpoint. The valid value is Z2FDTNDATAQYW2 for all the regions. For more // information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). DistributionHostedZoneId *string `locationName:"distributionHostedZoneId" type:"string"` // The custom domain name as an API host name, for example, my-api.example.com. DomainName *string `locationName:"domainName" type:"string"` // The status of the DomainName migration. The valid values are AVAILABLE and // UPDATING. If the status is UPDATING, the domain cannot be modified further // until the existing operation is complete. If it is AVAILABLE, the domain // can be updated. DomainNameStatus DomainNameStatus `locationName:"domainNameStatus" type:"string" enum:"true"` // An optional text message containing detailed information about status of // the DomainName migration. DomainNameStatusMessage *string `locationName:"domainNameStatusMessage" type:"string"` // The endpoint configuration of this DomainName showing the endpoint types // of the domain name. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The reference to an AWS-managed certificate that will be used for validating // the regional domain name. AWS Certificate Manager is the only supported source. RegionalCertificateArn *string `locationName:"regionalCertificateArn" type:"string"` // The name of the certificate that will be used for validating the regional // domain name. RegionalCertificateName *string `locationName:"regionalCertificateName" type:"string"` // The domain name associated with the regional endpoint for this custom domain // name. You set up this association by adding a DNS record that points the // custom domain name to this regional domain name. The regional domain name // is returned by API Gateway when you create a regional endpoint. RegionalDomainName *string `locationName:"regionalDomainName" type:"string"` // The region-specific Amazon Route 53 Hosted Zone ID of the regional endpoint. // For more information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). RegionalHostedZoneId *string `locationName:"regionalHostedZoneId" type:"string"` // The Transport Layer Security (TLS) version + cipher suite for this DomainName. // The valid values are TLS_1_0 and TLS_1_2. SecurityPolicy SecurityPolicy `locationName:"securityPolicy" type:"string" enum:"true"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a custom domain name as a user-friendly host name of an API (RestApi).
When you deploy an API, API Gateway creates a default host name for the API. This default API host name is of the {restapi-id}.execute-api.{region}.amazonaws.com format. With the default host name, you can access the API's root resource with the URL of https://{restapi-id}.execute-api.{region}.amazonaws.com/{stage}/. When you set up a custom domain name of apis.example.com for this API, you can then access the same resource using the URL of the https://apis.examples.com/myApi, where myApi is the base path mapping (BasePathMapping) of your API under the custom domain name.
Set a Custom Host Name for an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (DomainName) MarshalFields ¶
func (s DomainName) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (DomainName) String ¶
func (s DomainName) String() string
String returns the string representation
type DomainNameStatus ¶
type DomainNameStatus string
const ( DomainNameStatusAvailable DomainNameStatus = "AVAILABLE" DomainNameStatusUpdating DomainNameStatus = "UPDATING" DomainNameStatusPending DomainNameStatus = "PENDING" )
Enum values for DomainNameStatus
func (DomainNameStatus) MarshalValue ¶
func (enum DomainNameStatus) MarshalValue() (string, error)
func (DomainNameStatus) MarshalValueBuf ¶
func (enum DomainNameStatus) MarshalValueBuf(b []byte) ([]byte, error)
type EndpointConfiguration ¶
type EndpointConfiguration struct { // A list of endpoint types of an API (RestApi) or its custom domain name (DomainName). // For an edge-optimized API and its custom domain name, the endpoint type is // "EDGE". For a regional API and its custom domain name, the endpoint type // is REGIONAL. For a private API, the endpoint type is PRIVATE. Types []EndpointType `locationName:"types" type:"list"` // A list of VpcEndpointIds of an API (RestApi) against which to create Route53 // ALIASes. It is only supported for PRIVATE endpoint type. VpcEndpointIds []string `locationName:"vpcEndpointIds" type:"list"` // contains filtered or unexported fields }
The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.
func (EndpointConfiguration) MarshalFields ¶
func (s EndpointConfiguration) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (EndpointConfiguration) String ¶
func (s EndpointConfiguration) String() string
String returns the string representation
type EndpointType ¶
type EndpointType string
The endpoint type. The valid values are EDGE for edge-optimized API setup, most suitable for mobile applications; REGIONAL for regional API endpoint setup, most suitable for calling from AWS Region; and PRIVATE for private APIs.
const ( EndpointTypeRegional EndpointType = "REGIONAL" EndpointTypeEdge EndpointType = "EDGE" EndpointTypePrivate EndpointType = "PRIVATE" )
Enum values for EndpointType
func (EndpointType) MarshalValue ¶
func (enum EndpointType) MarshalValue() (string, error)
func (EndpointType) MarshalValueBuf ¶
func (enum EndpointType) MarshalValueBuf(b []byte) ([]byte, error)
type FlushStageAuthorizersCacheInput ¶
type FlushStageAuthorizersCacheInput struct { // The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // The name of the stage to flush. // // StageName is a required field StageName *string `location:"uri" locationName:"stage_name" type:"string" required:"true"` // contains filtered or unexported fields }
Request to flush authorizer cache entries on a specified stage.
func (FlushStageAuthorizersCacheInput) MarshalFields ¶
func (s FlushStageAuthorizersCacheInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (FlushStageAuthorizersCacheInput) String ¶
func (s FlushStageAuthorizersCacheInput) String() string
String returns the string representation
func (*FlushStageAuthorizersCacheInput) Validate ¶
func (s *FlushStageAuthorizersCacheInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type FlushStageAuthorizersCacheOutput ¶
type FlushStageAuthorizersCacheOutput struct {
// contains filtered or unexported fields
}
func (FlushStageAuthorizersCacheOutput) MarshalFields ¶
func (s FlushStageAuthorizersCacheOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (FlushStageAuthorizersCacheOutput) String ¶
func (s FlushStageAuthorizersCacheOutput) String() string
String returns the string representation
type FlushStageAuthorizersCacheRequest ¶
type FlushStageAuthorizersCacheRequest struct { *aws.Request Input *FlushStageAuthorizersCacheInput Copy func(*FlushStageAuthorizersCacheInput) FlushStageAuthorizersCacheRequest }
FlushStageAuthorizersCacheRequest is the request type for the FlushStageAuthorizersCache API operation.
func (FlushStageAuthorizersCacheRequest) Send ¶
func (r FlushStageAuthorizersCacheRequest) Send(ctx context.Context) (*FlushStageAuthorizersCacheResponse, error)
Send marshals and sends the FlushStageAuthorizersCache API request.
type FlushStageAuthorizersCacheResponse ¶
type FlushStageAuthorizersCacheResponse struct { *FlushStageAuthorizersCacheOutput // contains filtered or unexported fields }
FlushStageAuthorizersCacheResponse is the response type for the FlushStageAuthorizersCache API operation.
func (*FlushStageAuthorizersCacheResponse) SDKResponseMetdata ¶
func (r *FlushStageAuthorizersCacheResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the FlushStageAuthorizersCache request.
type FlushStageCacheInput ¶
type FlushStageCacheInput struct { // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The name of the stage to flush its cache. // // StageName is a required field StageName *string `location:"uri" locationName:"stage_name" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to flush a stage's cache.
func (FlushStageCacheInput) MarshalFields ¶
func (s FlushStageCacheInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (FlushStageCacheInput) String ¶
func (s FlushStageCacheInput) String() string
String returns the string representation
func (*FlushStageCacheInput) Validate ¶
func (s *FlushStageCacheInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type FlushStageCacheOutput ¶
type FlushStageCacheOutput struct {
// contains filtered or unexported fields
}
func (FlushStageCacheOutput) MarshalFields ¶
func (s FlushStageCacheOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (FlushStageCacheOutput) String ¶
func (s FlushStageCacheOutput) String() string
String returns the string representation
type FlushStageCacheRequest ¶
type FlushStageCacheRequest struct { *aws.Request Input *FlushStageCacheInput Copy func(*FlushStageCacheInput) FlushStageCacheRequest }
FlushStageCacheRequest is the request type for the FlushStageCache API operation.
func (FlushStageCacheRequest) Send ¶
func (r FlushStageCacheRequest) Send(ctx context.Context) (*FlushStageCacheResponse, error)
Send marshals and sends the FlushStageCache API request.
type FlushStageCacheResponse ¶
type FlushStageCacheResponse struct { *FlushStageCacheOutput // contains filtered or unexported fields }
FlushStageCacheResponse is the response type for the FlushStageCache API operation.
func (*FlushStageCacheResponse) SDKResponseMetdata ¶
func (r *FlushStageCacheResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the FlushStageCache request.
type GatewayResponse ¶
type GatewayResponse struct { // A Boolean flag to indicate whether this GatewayResponse is the default gateway // response (true) or not (false). A default gateway response is one generated // by API Gateway without any customization by an API developer. DefaultResponse *bool `locationName:"defaultResponse" type:"boolean"` // Response parameters (paths, query strings and headers) of the GatewayResponse // as a string-to-string map of key-value pairs. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Response templates of the GatewayResponse as a string-to-string map of key-value // pairs. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE ResponseType GatewayResponseType `locationName:"responseType" type:"string" enum:"true"` // The HTTP status code for this GatewayResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
A gateway response of a given response type and status code, with optional response parameters and mapping templates.
For more information about valid gateway response types, see Gateway Response Types Supported by API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html)
Example: Get a Gateway Response of a given response type
Request
This example shows how to get a gateway response of the MISSING_AUTHENTICATION_TOKEN type.
GET /restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN HTTP/1.1 Host: beta-apigateway.us-east-1.amazonaws.com Content-Type: application/json X-Amz-Date: 20170503T202516Z Authorization: AWS4-HMAC-SHA256 Credential={access-key-id}/20170503/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=1b52460e3159c1a26cff29093855d50ea141c1c5b937528fecaf60f51129697a Cache-Control: no-cache Postman-Token: 3b2a1ce9-c848-2e26-2e2f-9c2caefbed45
The response type is specified as a URL path.
Response
The successful operation returns the 200 OK status code and a payload similar to the following:
{ "_links": { "curies": { "href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-gatewayresponse-{rel}.html", "name": "gatewayresponse", "templated": true }, "self": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:delete": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" } }, "defaultResponse": false, "responseParameters": { "gatewayresponse.header.x-request-path": "method.request.path.petId", "gatewayresponse.header.Access-Control-Allow-Origin": "'a.b.c'", "gatewayresponse.header.x-request-query": "method.request.querystring.q", "gatewayresponse.header.x-request-header": "method.request.header.Accept" }, "responseTemplates": { "application/json": "{\n \"message\": $context.error.messageString,\n \"type\": \"$context.error.responseType\",\n \"stage\": \"$context.stage\",\n \"resourcePath\": \"$context.resourcePath\",\n \"stageVariables.a\": \"$stageVariables.a\",\n \"statusCode\": \"'404'\"\n}" }, "responseType": "MISSING_AUTHENTICATION_TOKEN", "statusCode": "404" }
Customize Gateway Responses (https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html)
func (GatewayResponse) MarshalFields ¶
func (s GatewayResponse) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GatewayResponse) String ¶
func (s GatewayResponse) String() string
String returns the string representation
type GatewayResponseType ¶
type GatewayResponseType string
const ( GatewayResponseTypeDefault4xx GatewayResponseType = "DEFAULT_4XX" GatewayResponseTypeDefault5xx GatewayResponseType = "DEFAULT_5XX" GatewayResponseTypeResourceNotFound GatewayResponseType = "RESOURCE_NOT_FOUND" GatewayResponseType = "UNAUTHORIZED" GatewayResponseTypeInvalidApiKey GatewayResponseType = "INVALID_API_KEY" GatewayResponseTypeAccessDenied GatewayResponseType = "ACCESS_DENIED" GatewayResponseTypeAuthorizerFailure GatewayResponseType = "AUTHORIZER_FAILURE" GatewayResponseTypeAuthorizerConfigurationError GatewayResponseType = "AUTHORIZER_CONFIGURATION_ERROR" GatewayResponseTypeInvalidSignature GatewayResponseType = "INVALID_SIGNATURE" GatewayResponseTypeExpiredToken GatewayResponseType = "EXPIRED_TOKEN" GatewayResponseTypeMissingAuthenticationToken GatewayResponseType = "MISSING_AUTHENTICATION_TOKEN" GatewayResponseTypeIntegrationFailure GatewayResponseType = "INTEGRATION_FAILURE" GatewayResponseTypeIntegrationTimeout GatewayResponseType = "INTEGRATION_TIMEOUT" GatewayResponseTypeApiConfigurationError GatewayResponseType = "API_CONFIGURATION_ERROR" GatewayResponseTypeUnsupportedMediaType GatewayResponseType = "UNSUPPORTED_MEDIA_TYPE" GatewayResponseTypeBadRequestParameters GatewayResponseType = "BAD_REQUEST_PARAMETERS" GatewayResponseTypeBadRequestBody GatewayResponseType = "BAD_REQUEST_BODY" GatewayResponseTypeRequestTooLarge GatewayResponseType = "REQUEST_TOO_LARGE" GatewayResponseTypeThrottled GatewayResponseType = "THROTTLED" GatewayResponseTypeQuotaExceeded GatewayResponseType = "QUOTA_EXCEEDED" )
Enum values for GatewayResponseType
func (GatewayResponseType) MarshalValue ¶
func (enum GatewayResponseType) MarshalValue() (string, error)
func (GatewayResponseType) MarshalValueBuf ¶
func (enum GatewayResponseType) MarshalValueBuf(b []byte) ([]byte, error)
type GenerateClientCertificateInput ¶
type GenerateClientCertificateInput struct { // The description of the ClientCertificate. Description *string `locationName:"description" type:"string"` // 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. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
A request to generate a ClientCertificate resource.
func (GenerateClientCertificateInput) MarshalFields ¶
func (s GenerateClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GenerateClientCertificateInput) String ¶
func (s GenerateClientCertificateInput) String() string
String returns the string representation
type GenerateClientCertificateOutput ¶
type GenerateClientCertificateOutput struct { // The identifier of the client certificate. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the client certificate was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the client certificate. Description *string `locationName:"description" type:"string"` // The timestamp when the client certificate will expire. ExpirationDate *time.Time `locationName:"expirationDate" type:"timestamp"` // The PEM-encoded public key of the client certificate, which can be used to // configure certificate authentication in the integration endpoint . PemEncodedCertificate *string `locationName:"pemEncodedCertificate" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a client certificate used to configure client-side SSL authentication while sending requests to the integration endpoint.
Client certificates are used to authenticate an API by the backend server. To authenticate an API client (or user), use IAM roles and policies, a custom Authorizer or an Amazon Cognito user pool.
Use Client-Side Certificate (https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
func (GenerateClientCertificateOutput) MarshalFields ¶
func (s GenerateClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GenerateClientCertificateOutput) String ¶
func (s GenerateClientCertificateOutput) String() string
String returns the string representation
type GenerateClientCertificateRequest ¶
type GenerateClientCertificateRequest struct { *aws.Request Input *GenerateClientCertificateInput Copy func(*GenerateClientCertificateInput) GenerateClientCertificateRequest }
GenerateClientCertificateRequest is the request type for the GenerateClientCertificate API operation.
func (GenerateClientCertificateRequest) Send ¶
func (r GenerateClientCertificateRequest) Send(ctx context.Context) (*GenerateClientCertificateResponse, error)
Send marshals and sends the GenerateClientCertificate API request.
type GenerateClientCertificateResponse ¶
type GenerateClientCertificateResponse struct { *GenerateClientCertificateOutput // contains filtered or unexported fields }
GenerateClientCertificateResponse is the response type for the GenerateClientCertificate API operation.
func (*GenerateClientCertificateResponse) SDKResponseMetdata ¶
func (r *GenerateClientCertificateResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GenerateClientCertificate request.
type GetAccountInput ¶
type GetAccountInput struct {
// contains filtered or unexported fields
}
Requests API Gateway to get information about the current Account resource.
func (GetAccountInput) MarshalFields ¶
func (s GetAccountInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetAccountInput) String ¶
func (s GetAccountInput) String() string
String returns the string representation
type GetAccountOutput ¶
type GetAccountOutput struct { // The version of the API keys used for the account. ApiKeyVersion *string `locationName:"apiKeyVersion" type:"string"` // The ARN of an Amazon CloudWatch role for the current Account. CloudwatchRoleArn *string `locationName:"cloudwatchRoleArn" type:"string"` // A list of features supported for the account. When usage plans are enabled, // the features list will include an entry of "UsagePlans". Features []string `locationName:"features" type:"list"` // Specifies the API request limits configured for the current Account. ThrottleSettings *ThrottleSettings `locationName:"throttleSettings" type:"structure"` // contains filtered or unexported fields }
Represents an AWS account that is associated with API Gateway.
To view the account info, call GET on this resource.
Error Codes
The following exception may be thrown when the request fails.
UnauthorizedException
NotFoundException
TooManyRequestsException
For detailed error code information, including the corresponding HTTP Status Codes, see API Gateway Error Codes (https://docs.aws.amazon.com/apigateway/api-reference/handling-errors/#api-error-codes)
Example: Get the information about an account.
Request
GET /account HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160531T184618Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns a 200 OK status code and a payload similar to the following:
{ "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/account-apigateway-{rel}.html", "name": "account", "templated": true }, "self": { "href": "/account" }, "account:update": { "href": "/account" } }, "cloudwatchRoleArn": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "throttleSettings": { "rateLimit": 500, "burstLimit": 1000 } }
In addition to making the REST API call directly, you can use the AWS CLI and an AWS SDK to access this resource.
API Gateway Limits (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-limits.html) Developer Guide (https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html), AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-account.html)
func (GetAccountOutput) MarshalFields ¶
func (s GetAccountOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetAccountOutput) String ¶
func (s GetAccountOutput) String() string
String returns the string representation
type GetAccountRequest ¶
type GetAccountRequest struct { *aws.Request Input *GetAccountInput Copy func(*GetAccountInput) GetAccountRequest }
GetAccountRequest is the request type for the GetAccount API operation.
func (GetAccountRequest) Send ¶
func (r GetAccountRequest) Send(ctx context.Context) (*GetAccountResponse, error)
Send marshals and sends the GetAccount API request.
type GetAccountResponse ¶
type GetAccountResponse struct { *GetAccountOutput // contains filtered or unexported fields }
GetAccountResponse is the response type for the GetAccount API operation.
func (*GetAccountResponse) SDKResponseMetdata ¶
func (r *GetAccountResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetAccount request.
type GetApiKeyInput ¶
type GetApiKeyInput struct { // [Required] The identifier of the ApiKey resource. // // ApiKey is a required field ApiKey *string `location:"uri" locationName:"api_Key" type:"string" required:"true"` // A boolean flag to specify whether (true) or not (false) the result contains // the key value. IncludeValue *bool `location:"querystring" locationName:"includeValue" type:"boolean"` // contains filtered or unexported fields }
A request to get information about the current ApiKey resource.
func (GetApiKeyInput) MarshalFields ¶
func (s GetApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetApiKeyInput) String ¶
func (s GetApiKeyInput) String() string
String returns the string representation
func (*GetApiKeyInput) Validate ¶
func (s *GetApiKeyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetApiKeyOutput ¶
type GetApiKeyOutput struct { // The timestamp when the API Key was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // An AWS Marketplace customer identifier , when integrating with the AWS SaaS // Marketplace. CustomerId *string `locationName:"customerId" type:"string"` // The description of the API Key. Description *string `locationName:"description" type:"string"` // Specifies whether the API Key can be used by callers. Enabled *bool `locationName:"enabled" type:"boolean"` // The identifier of the API Key. Id *string `locationName:"id" type:"string"` // The timestamp when the API Key was last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // The name of the API Key. Name *string `locationName:"name" type:"string"` // A list of Stage resources that are associated with the ApiKey resource. StageKeys []string `locationName:"stageKeys" type:"list"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The value of the API Key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
A resource that can be distributed to callers for executing Method resources that require an API key. API keys can be mapped to any Stage on any RestApi, which indicates that the callers with the API key can make requests to that stage.
Use API Keys (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-api-keys.html)
func (GetApiKeyOutput) MarshalFields ¶
func (s GetApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetApiKeyOutput) String ¶
func (s GetApiKeyOutput) String() string
String returns the string representation
type GetApiKeyRequest ¶
type GetApiKeyRequest struct { *aws.Request Input *GetApiKeyInput Copy func(*GetApiKeyInput) GetApiKeyRequest }
GetApiKeyRequest is the request type for the GetApiKey API operation.
func (GetApiKeyRequest) Send ¶
func (r GetApiKeyRequest) Send(ctx context.Context) (*GetApiKeyResponse, error)
Send marshals and sends the GetApiKey API request.
type GetApiKeyResponse ¶
type GetApiKeyResponse struct { *GetApiKeyOutput // contains filtered or unexported fields }
GetApiKeyResponse is the response type for the GetApiKey API operation.
func (*GetApiKeyResponse) SDKResponseMetdata ¶
func (r *GetApiKeyResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetApiKey request.
type GetApiKeysInput ¶
type GetApiKeysInput struct { // The identifier of a customer in AWS Marketplace or an external system, such // as a developer portal. CustomerId *string `location:"querystring" locationName:"customerId" type:"string"` // A boolean flag to specify whether (true) or not (false) the result contains // key values. IncludeValues *bool `location:"querystring" locationName:"includeValues" type:"boolean"` // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The name of queried API keys. NameQuery *string `location:"querystring" locationName:"name" type:"string"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
A request to get information about the current ApiKeys resource.
func (GetApiKeysInput) MarshalFields ¶
func (s GetApiKeysInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetApiKeysInput) String ¶
func (s GetApiKeysInput) String() string
String returns the string representation
type GetApiKeysOutput ¶
type GetApiKeysOutput struct { // The current page of elements from this collection. Items []ApiKey `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // A list of warning messages logged during the import of API keys when the // failOnWarnings option is set to true. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
Represents a collection of API keys as represented by an ApiKeys resource.
Use API Keys (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-api-keys.html)
func (GetApiKeysOutput) MarshalFields ¶
func (s GetApiKeysOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetApiKeysOutput) String ¶
func (s GetApiKeysOutput) String() string
String returns the string representation
type GetApiKeysPaginator ¶
GetApiKeysPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetApiKeysPaginator ¶
func NewGetApiKeysPaginator(req GetApiKeysRequest) GetApiKeysPaginator
NewGetApiKeysRequestPaginator returns a paginator for GetApiKeys. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetApiKeysRequest(input) p := apigateway.NewGetApiKeysRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetApiKeysPaginator) CurrentPage ¶
func (p *GetApiKeysPaginator) CurrentPage() *GetApiKeysOutput
type GetApiKeysRequest ¶
type GetApiKeysRequest struct { *aws.Request Input *GetApiKeysInput Copy func(*GetApiKeysInput) GetApiKeysRequest }
GetApiKeysRequest is the request type for the GetApiKeys API operation.
func (GetApiKeysRequest) Send ¶
func (r GetApiKeysRequest) Send(ctx context.Context) (*GetApiKeysResponse, error)
Send marshals and sends the GetApiKeys API request.
type GetApiKeysResponse ¶
type GetApiKeysResponse struct { *GetApiKeysOutput // contains filtered or unexported fields }
GetApiKeysResponse is the response type for the GetApiKeys API operation.
func (*GetApiKeysResponse) SDKResponseMetdata ¶
func (r *GetApiKeysResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetApiKeys request.
type GetAuthorizerInput ¶
type GetAuthorizerInput struct { // [Required] The identifier of the Authorizer resource. // // AuthorizerId is a required field AuthorizerId *string `location:"uri" locationName:"authorizer_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to describe an existing Authorizer resource.
func (GetAuthorizerInput) MarshalFields ¶
func (s GetAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetAuthorizerInput) String ¶
func (s GetAuthorizerInput) String() string
String returns the string representation
func (*GetAuthorizerInput) Validate ¶
func (s *GetAuthorizerInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetAuthorizerOutput ¶
type GetAuthorizerOutput struct { // Optional customer-defined field, used in OpenAPI imports and exports without // functional impact. AuthType *string `locationName:"authType" type:"string"` // Specifies the required credentials as an IAM role for API Gateway to invoke // the authorizer. To specify an IAM role for API Gateway to assume, use the // role's Amazon Resource Name (ARN). To use resource-based permissions on the // Lambda function, specify null. AuthorizerCredentials *string `locationName:"authorizerCredentials" type:"string"` // The TTL in seconds of cached authorizer results. If it equals 0, authorization // caching is disabled. If it is greater than 0, API Gateway will cache authorizer // responses. If this field is not set, the default value is 300. The maximum // value is 3600, or 1 hour. AuthorizerResultTtlInSeconds *int64 `locationName:"authorizerResultTtlInSeconds" type:"integer"` // Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN or // REQUEST authorizers, this must be a well-formed Lambda function URI, for // example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations. // In general, the URI has this form arn:aws:apigateway:{region}:lambda:path/{service_api}, // where {region} is the same as the region hosting the Lambda function, path // indicates that the remaining substring in the URI should be treated as the // path to the resource, including the initial /. For Lambda functions, this // is usually of the form /2015-03-31/functions/[FunctionARN]/invocations. AuthorizerUri *string `locationName:"authorizerUri" type:"string"` // The identifier for the authorizer resource. Id *string `locationName:"id" type:"string"` // The identity source for which authorization is requested. // * For a TOKEN or COGNITO_USER_POOLS authorizer, this is required and specifies // the request header mapping expression for the custom header holding the // authorization token submitted by the client. For example, if the token // header name is Auth, the header mapping expression is method.request.header.Auth. // // * For the REQUEST authorizer, this is required when authorization caching // is enabled. The value is a comma-separated string of one or more mapping // expressions of the specified request parameters. For example, if an Auth // header, a Name query string parameter are defined as identity sources, // this value is method.request.header.Auth, method.request.querystring.Name. // These parameters will be used to derive the authorization caching key // and to perform runtime validation of the REQUEST authorizer by verifying // all of the identity-related request parameters are present, not null and // non-empty. Only when this is true does the authorizer invoke the authorizer // Lambda function, otherwise, it returns a 401 Unauthorized response without // calling the Lambda function. The valid value is a string of comma-separated // mapping expressions of the specified request parameters. When the authorization // caching is not enabled, this property is optional. IdentitySource *string `locationName:"identitySource" type:"string"` // A validation expression for the incoming identity token. For TOKEN authorizers, // this value is a regular expression. For COGNITO_USER_POOLS authorizers, API // Gateway will match the aud field of the incoming token from the client against // the specified regular expression. It will invoke the authorizer's Lambda // function when there is a match. Otherwise, it will return a 401 Unauthorized // response without calling the Lambda function. The validation expression does // not apply to the REQUEST authorizer. IdentityValidationExpression *string `locationName:"identityValidationExpression" type:"string"` // [Required] The name of the authorizer. Name *string `locationName:"name" type:"string"` // A list of the Amazon Cognito user pool ARNs for the COGNITO_USER_POOLS authorizer. // Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}. // For a TOKEN or REQUEST authorizer, this is not defined. ProviderARNs []string `locationName:"providerARNs" type:"list"` // The authorizer type. Valid values are TOKEN for a Lambda function using a // single authorization token submitted in a custom header, REQUEST for a Lambda // function using incoming request parameters, and COGNITO_USER_POOLS for using // an Amazon Cognito user pool. Type AuthorizerType `locationName:"type" type:"string" enum:"true"` // contains filtered or unexported fields }
Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.
Use Lambda Function as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html) Use Cognito User Pool as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html)
func (GetAuthorizerOutput) MarshalFields ¶
func (s GetAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetAuthorizerOutput) String ¶
func (s GetAuthorizerOutput) String() string
String returns the string representation
type GetAuthorizerRequest ¶
type GetAuthorizerRequest struct { *aws.Request Input *GetAuthorizerInput Copy func(*GetAuthorizerInput) GetAuthorizerRequest }
GetAuthorizerRequest is the request type for the GetAuthorizer API operation.
func (GetAuthorizerRequest) Send ¶
func (r GetAuthorizerRequest) Send(ctx context.Context) (*GetAuthorizerResponse, error)
Send marshals and sends the GetAuthorizer API request.
type GetAuthorizerResponse ¶
type GetAuthorizerResponse struct { *GetAuthorizerOutput // contains filtered or unexported fields }
GetAuthorizerResponse is the response type for the GetAuthorizer API operation.
func (*GetAuthorizerResponse) SDKResponseMetdata ¶
func (r *GetAuthorizerResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetAuthorizer request.
type GetAuthorizersInput ¶
type GetAuthorizersInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to describe an existing Authorizers resource.
func (GetAuthorizersInput) MarshalFields ¶
func (s GetAuthorizersInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetAuthorizersInput) String ¶
func (s GetAuthorizersInput) String() string
String returns the string representation
func (*GetAuthorizersInput) Validate ¶
func (s *GetAuthorizersInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetAuthorizersOutput ¶
type GetAuthorizersOutput struct { // The current page of elements from this collection. Items []Authorizer `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection of Authorizer resources.
Use Lambda Function as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html) Use Cognito User Pool as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html)
func (GetAuthorizersOutput) MarshalFields ¶
func (s GetAuthorizersOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetAuthorizersOutput) String ¶
func (s GetAuthorizersOutput) String() string
String returns the string representation
type GetAuthorizersRequest ¶
type GetAuthorizersRequest struct { *aws.Request Input *GetAuthorizersInput Copy func(*GetAuthorizersInput) GetAuthorizersRequest }
GetAuthorizersRequest is the request type for the GetAuthorizers API operation.
func (GetAuthorizersRequest) Send ¶
func (r GetAuthorizersRequest) Send(ctx context.Context) (*GetAuthorizersResponse, error)
Send marshals and sends the GetAuthorizers API request.
type GetAuthorizersResponse ¶
type GetAuthorizersResponse struct { *GetAuthorizersOutput // contains filtered or unexported fields }
GetAuthorizersResponse is the response type for the GetAuthorizers API operation.
func (*GetAuthorizersResponse) SDKResponseMetdata ¶
func (r *GetAuthorizersResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetAuthorizers request.
type GetBasePathMappingInput ¶
type GetBasePathMappingInput struct { // [Required] The base path name that callers of the API must provide as part // of the URL after the domain name. This value must be unique for all of the // mappings across a single API. Specify '(none)' if you do not want callers // to specify any base path name after the domain name. // // BasePath is a required field BasePath *string `location:"uri" locationName:"base_path" type:"string" required:"true"` // [Required] The domain name of the BasePathMapping resource to be described. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // contains filtered or unexported fields }
Request to describe a BasePathMapping resource.
func (GetBasePathMappingInput) MarshalFields ¶
func (s GetBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetBasePathMappingInput) String ¶
func (s GetBasePathMappingInput) String() string
String returns the string representation
func (*GetBasePathMappingInput) Validate ¶
func (s *GetBasePathMappingInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetBasePathMappingOutput ¶
type GetBasePathMappingOutput struct { // The base path name that callers of the API must provide as part of the URL // after the domain name. BasePath *string `locationName:"basePath" type:"string"` // The string identifier of the associated RestApi. RestApiId *string `locationName:"restApiId" type:"string"` // The name of the associated stage. Stage *string `locationName:"stage" type:"string"` // contains filtered or unexported fields }
Represents the base path that callers of the API must provide as part of the URL after the domain name.
A custom domain name plus a BasePathMapping specification identifies a deployed RestApi in a given stage of the owner Account.
Use Custom Domain Names (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (GetBasePathMappingOutput) MarshalFields ¶
func (s GetBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetBasePathMappingOutput) String ¶
func (s GetBasePathMappingOutput) String() string
String returns the string representation
type GetBasePathMappingRequest ¶
type GetBasePathMappingRequest struct { *aws.Request Input *GetBasePathMappingInput Copy func(*GetBasePathMappingInput) GetBasePathMappingRequest }
GetBasePathMappingRequest is the request type for the GetBasePathMapping API operation.
func (GetBasePathMappingRequest) Send ¶
func (r GetBasePathMappingRequest) Send(ctx context.Context) (*GetBasePathMappingResponse, error)
Send marshals and sends the GetBasePathMapping API request.
type GetBasePathMappingResponse ¶
type GetBasePathMappingResponse struct { *GetBasePathMappingOutput // contains filtered or unexported fields }
GetBasePathMappingResponse is the response type for the GetBasePathMapping API operation.
func (*GetBasePathMappingResponse) SDKResponseMetdata ¶
func (r *GetBasePathMappingResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetBasePathMapping request.
type GetBasePathMappingsInput ¶
type GetBasePathMappingsInput struct { // [Required] The domain name of a BasePathMapping resource. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
A request to get information about a collection of BasePathMapping resources.
func (GetBasePathMappingsInput) MarshalFields ¶
func (s GetBasePathMappingsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetBasePathMappingsInput) String ¶
func (s GetBasePathMappingsInput) String() string
String returns the string representation
func (*GetBasePathMappingsInput) Validate ¶
func (s *GetBasePathMappingsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetBasePathMappingsOutput ¶
type GetBasePathMappingsOutput struct { // The current page of elements from this collection. Items []BasePathMapping `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection of BasePathMapping resources.
Use Custom Domain Names (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (GetBasePathMappingsOutput) MarshalFields ¶
func (s GetBasePathMappingsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetBasePathMappingsOutput) String ¶
func (s GetBasePathMappingsOutput) String() string
String returns the string representation
type GetBasePathMappingsPaginator ¶
GetBasePathMappingsPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetBasePathMappingsPaginator ¶
func NewGetBasePathMappingsPaginator(req GetBasePathMappingsRequest) GetBasePathMappingsPaginator
NewGetBasePathMappingsRequestPaginator returns a paginator for GetBasePathMappings. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetBasePathMappingsRequest(input) p := apigateway.NewGetBasePathMappingsRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetBasePathMappingsPaginator) CurrentPage ¶
func (p *GetBasePathMappingsPaginator) CurrentPage() *GetBasePathMappingsOutput
type GetBasePathMappingsRequest ¶
type GetBasePathMappingsRequest struct { *aws.Request Input *GetBasePathMappingsInput Copy func(*GetBasePathMappingsInput) GetBasePathMappingsRequest }
GetBasePathMappingsRequest is the request type for the GetBasePathMappings API operation.
func (GetBasePathMappingsRequest) Send ¶
func (r GetBasePathMappingsRequest) Send(ctx context.Context) (*GetBasePathMappingsResponse, error)
Send marshals and sends the GetBasePathMappings API request.
type GetBasePathMappingsResponse ¶
type GetBasePathMappingsResponse struct { *GetBasePathMappingsOutput // contains filtered or unexported fields }
GetBasePathMappingsResponse is the response type for the GetBasePathMappings API operation.
func (*GetBasePathMappingsResponse) SDKResponseMetdata ¶
func (r *GetBasePathMappingsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetBasePathMappings request.
type GetClientCertificateInput ¶
type GetClientCertificateInput struct { // [Required] The identifier of the ClientCertificate resource to be described. // // ClientCertificateId is a required field ClientCertificateId *string `location:"uri" locationName:"clientcertificate_id" type:"string" required:"true"` // contains filtered or unexported fields }
A request to get information about the current ClientCertificate resource.
func (GetClientCertificateInput) MarshalFields ¶
func (s GetClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetClientCertificateInput) String ¶
func (s GetClientCertificateInput) String() string
String returns the string representation
func (*GetClientCertificateInput) Validate ¶
func (s *GetClientCertificateInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetClientCertificateOutput ¶
type GetClientCertificateOutput struct { // The identifier of the client certificate. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the client certificate was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the client certificate. Description *string `locationName:"description" type:"string"` // The timestamp when the client certificate will expire. ExpirationDate *time.Time `locationName:"expirationDate" type:"timestamp"` // The PEM-encoded public key of the client certificate, which can be used to // configure certificate authentication in the integration endpoint . PemEncodedCertificate *string `locationName:"pemEncodedCertificate" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a client certificate used to configure client-side SSL authentication while sending requests to the integration endpoint.
Client certificates are used to authenticate an API by the backend server. To authenticate an API client (or user), use IAM roles and policies, a custom Authorizer or an Amazon Cognito user pool.
Use Client-Side Certificate (https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
func (GetClientCertificateOutput) MarshalFields ¶
func (s GetClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetClientCertificateOutput) String ¶
func (s GetClientCertificateOutput) String() string
String returns the string representation
type GetClientCertificateRequest ¶
type GetClientCertificateRequest struct { *aws.Request Input *GetClientCertificateInput Copy func(*GetClientCertificateInput) GetClientCertificateRequest }
GetClientCertificateRequest is the request type for the GetClientCertificate API operation.
func (GetClientCertificateRequest) Send ¶
func (r GetClientCertificateRequest) Send(ctx context.Context) (*GetClientCertificateResponse, error)
Send marshals and sends the GetClientCertificate API request.
type GetClientCertificateResponse ¶
type GetClientCertificateResponse struct { *GetClientCertificateOutput // contains filtered or unexported fields }
GetClientCertificateResponse is the response type for the GetClientCertificate API operation.
func (*GetClientCertificateResponse) SDKResponseMetdata ¶
func (r *GetClientCertificateResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetClientCertificate request.
type GetClientCertificatesInput ¶
type GetClientCertificatesInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
A request to get information about a collection of ClientCertificate resources.
func (GetClientCertificatesInput) MarshalFields ¶
func (s GetClientCertificatesInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetClientCertificatesInput) String ¶
func (s GetClientCertificatesInput) String() string
String returns the string representation
type GetClientCertificatesOutput ¶
type GetClientCertificatesOutput struct { // The current page of elements from this collection. Items []Certificate `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection of ClientCertificate resources.
Use Client-Side Certificate (https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
func (GetClientCertificatesOutput) MarshalFields ¶
func (s GetClientCertificatesOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetClientCertificatesOutput) String ¶
func (s GetClientCertificatesOutput) String() string
String returns the string representation
type GetClientCertificatesPaginator ¶
GetClientCertificatesPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetClientCertificatesPaginator ¶
func NewGetClientCertificatesPaginator(req GetClientCertificatesRequest) GetClientCertificatesPaginator
NewGetClientCertificatesRequestPaginator returns a paginator for GetClientCertificates. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetClientCertificatesRequest(input) p := apigateway.NewGetClientCertificatesRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetClientCertificatesPaginator) CurrentPage ¶
func (p *GetClientCertificatesPaginator) CurrentPage() *GetClientCertificatesOutput
type GetClientCertificatesRequest ¶
type GetClientCertificatesRequest struct { *aws.Request Input *GetClientCertificatesInput Copy func(*GetClientCertificatesInput) GetClientCertificatesRequest }
GetClientCertificatesRequest is the request type for the GetClientCertificates API operation.
func (GetClientCertificatesRequest) Send ¶
func (r GetClientCertificatesRequest) Send(ctx context.Context) (*GetClientCertificatesResponse, error)
Send marshals and sends the GetClientCertificates API request.
type GetClientCertificatesResponse ¶
type GetClientCertificatesResponse struct { *GetClientCertificatesOutput // contains filtered or unexported fields }
GetClientCertificatesResponse is the response type for the GetClientCertificates API operation.
func (*GetClientCertificatesResponse) SDKResponseMetdata ¶
func (r *GetClientCertificatesResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetClientCertificates request.
type GetDeploymentInput ¶
type GetDeploymentInput struct { // [Required] The identifier of the Deployment resource to get information about. // // DeploymentId is a required field DeploymentId *string `location:"uri" locationName:"deployment_id" type:"string" required:"true"` // A query parameter to retrieve the specified embedded resources of the returned // Deployment resource in the response. In a REST API call, this embed parameter // value is a list of comma-separated strings, as in GET /restapis/{restapi_id}/deployments/{deployment_id}?embed=var1,var2. // The SDK and other platform-dependent libraries might use a different format // for the list. Currently, this request supports only retrieval of the embedded // API summary this way. Hence, the parameter value must be a single-valued // list containing only the "apisummary" string. For example, GET /restapis/{restapi_id}/deployments/{deployment_id}?embed=apisummary. Embed []string `location:"querystring" locationName:"embed" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to get information about a Deployment resource.
func (GetDeploymentInput) MarshalFields ¶
func (s GetDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDeploymentInput) String ¶
func (s GetDeploymentInput) String() string
String returns the string representation
func (*GetDeploymentInput) Validate ¶
func (s *GetDeploymentInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDeploymentOutput ¶
type GetDeploymentOutput struct { // A summary of the RestApi at the date and time that the deployment resource // was created. ApiSummary map[string]map[string]MethodSnapshot `locationName:"apiSummary" type:"map"` // The date and time that the deployment resource was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description for the deployment resource. Description *string `locationName:"description" type:"string"` // The identifier for the deployment resource. Id *string `locationName:"id" type:"string"` // contains filtered or unexported fields }
An immutable representation of a RestApi resource that can be called by users using Stages. A deployment must be associated with a Stage for it to be callable over the Internet.
To create a deployment, call POST on the Deployments resource of a RestApi. To view, update, or delete a deployment, call GET, PATCH, or DELETE on the specified deployment resource (/restapis/{restapi_id}/deployments/{deployment_id}).
RestApi, Deployments, Stage, AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-deployment.html), AWS SDKs (https://aws.amazon.com/tools/)
func (GetDeploymentOutput) MarshalFields ¶
func (s GetDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDeploymentOutput) String ¶
func (s GetDeploymentOutput) String() string
String returns the string representation
type GetDeploymentRequest ¶
type GetDeploymentRequest struct { *aws.Request Input *GetDeploymentInput Copy func(*GetDeploymentInput) GetDeploymentRequest }
GetDeploymentRequest is the request type for the GetDeployment API operation.
func (GetDeploymentRequest) Send ¶
func (r GetDeploymentRequest) Send(ctx context.Context) (*GetDeploymentResponse, error)
Send marshals and sends the GetDeployment API request.
type GetDeploymentResponse ¶
type GetDeploymentResponse struct { *GetDeploymentOutput // contains filtered or unexported fields }
GetDeploymentResponse is the response type for the GetDeployment API operation.
func (*GetDeploymentResponse) SDKResponseMetdata ¶
func (r *GetDeploymentResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDeployment request.
type GetDeploymentsInput ¶
type GetDeploymentsInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to get information about a Deployments collection.
func (GetDeploymentsInput) MarshalFields ¶
func (s GetDeploymentsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDeploymentsInput) String ¶
func (s GetDeploymentsInput) String() string
String returns the string representation
func (*GetDeploymentsInput) Validate ¶
func (s *GetDeploymentsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDeploymentsOutput ¶
type GetDeploymentsOutput struct { // The current page of elements from this collection. Items []Deployment `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection resource that contains zero or more references to your existing deployments, and links that guide you on how to interact with your collection. The collection offers a paginated view of the contained deployments.
To create a new deployment of a RestApi, make a POST request against this resource. To view, update, or delete an existing deployment, make a GET, PATCH, or DELETE request, respectively, on a specified Deployment resource.
Deploying an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-deploy-api.html), AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-deployment.html), AWS SDKs (https://aws.amazon.com/tools/)
func (GetDeploymentsOutput) MarshalFields ¶
func (s GetDeploymentsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDeploymentsOutput) String ¶
func (s GetDeploymentsOutput) String() string
String returns the string representation
type GetDeploymentsPaginator ¶
GetDeploymentsPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetDeploymentsPaginator ¶
func NewGetDeploymentsPaginator(req GetDeploymentsRequest) GetDeploymentsPaginator
NewGetDeploymentsRequestPaginator returns a paginator for GetDeployments. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetDeploymentsRequest(input) p := apigateway.NewGetDeploymentsRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetDeploymentsPaginator) CurrentPage ¶
func (p *GetDeploymentsPaginator) CurrentPage() *GetDeploymentsOutput
type GetDeploymentsRequest ¶
type GetDeploymentsRequest struct { *aws.Request Input *GetDeploymentsInput Copy func(*GetDeploymentsInput) GetDeploymentsRequest }
GetDeploymentsRequest is the request type for the GetDeployments API operation.
func (GetDeploymentsRequest) Send ¶
func (r GetDeploymentsRequest) Send(ctx context.Context) (*GetDeploymentsResponse, error)
Send marshals and sends the GetDeployments API request.
type GetDeploymentsResponse ¶
type GetDeploymentsResponse struct { *GetDeploymentsOutput // contains filtered or unexported fields }
GetDeploymentsResponse is the response type for the GetDeployments API operation.
func (*GetDeploymentsResponse) SDKResponseMetdata ¶
func (r *GetDeploymentsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDeployments request.
type GetDocumentationPartInput ¶
type GetDocumentationPartInput struct { // [Required] The string identifier of the associated RestApi. // // DocumentationPartId is a required field DocumentationPartId *string `location:"uri" locationName:"part_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets a specified documentation part of a given API.
func (GetDocumentationPartInput) MarshalFields ¶
func (s GetDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationPartInput) String ¶
func (s GetDocumentationPartInput) String() string
String returns the string representation
func (*GetDocumentationPartInput) Validate ¶
func (s *GetDocumentationPartInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDocumentationPartOutput ¶
type GetDocumentationPartOutput struct { // The DocumentationPart identifier, generated by API Gateway when the DocumentationPart // is created. Id *string `locationName:"id" type:"string"` // The location of the API entity to which the documentation applies. Valid // fields depend on the targeted API entity type. All the valid location fields // are not required. If not explicitly specified, a valid location field is // treated as a wildcard and associated documentation content may be inherited // by matching entities, unless overridden. Location *DocumentationPartLocation `locationName:"location" type:"structure"` // 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 OpenAPI-compliant documentation-related fields // from the properties map are exported and, hence, published as part of the // API entity definitions, while the original documentation parts are exported // in a OpenAPI extension of x-amazon-apigateway-documentation. Properties *string `locationName:"properties" type:"string"` // contains filtered or unexported fields }
A documentation part for a targeted API entity.
A documentation part consists of a content map (properties) and a target (location). The target specifies an API entity to which the documentation content applies. The supported API entity types are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Valid location fields depend on the API entity type. All valid fields are not required.
The content map is a JSON string of API-specific key-value pairs. Although an API can use any shape for the content map, only the OpenAPI-compliant documentation fields will be injected into the associated API entity definition in the exported OpenAPI definition file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationParts
func (GetDocumentationPartOutput) MarshalFields ¶
func (s GetDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationPartOutput) String ¶
func (s GetDocumentationPartOutput) String() string
String returns the string representation
type GetDocumentationPartRequest ¶
type GetDocumentationPartRequest struct { *aws.Request Input *GetDocumentationPartInput Copy func(*GetDocumentationPartInput) GetDocumentationPartRequest }
GetDocumentationPartRequest is the request type for the GetDocumentationPart API operation.
func (GetDocumentationPartRequest) Send ¶
func (r GetDocumentationPartRequest) Send(ctx context.Context) (*GetDocumentationPartResponse, error)
Send marshals and sends the GetDocumentationPart API request.
type GetDocumentationPartResponse ¶
type GetDocumentationPartResponse struct { *GetDocumentationPartOutput // contains filtered or unexported fields }
GetDocumentationPartResponse is the response type for the GetDocumentationPart API operation.
func (*GetDocumentationPartResponse) SDKResponseMetdata ¶
func (r *GetDocumentationPartResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDocumentationPart request.
type GetDocumentationPartsInput ¶
type GetDocumentationPartsInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The status of the API documentation parts to retrieve. Valid values are DOCUMENTED // for retrieving DocumentationPart resources with content and UNDOCUMENTED // for DocumentationPart resources without content. LocationStatus LocationStatusType `location:"querystring" locationName:"locationStatus" type:"string" enum:"true"` // The name of API entities of the to-be-retrieved documentation parts. NameQuery *string `location:"querystring" locationName:"name" type:"string"` // The path of API entities of the to-be-retrieved documentation parts. Path *string `location:"querystring" locationName:"path" type:"string"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // The type of API entities of the to-be-retrieved documentation parts. Type DocumentationPartType `location:"querystring" locationName:"type" type:"string" enum:"true"` // contains filtered or unexported fields }
Gets the documentation parts of an API. The result may be filtered by the type, name, or path of API entities (targets).
func (GetDocumentationPartsInput) MarshalFields ¶
func (s GetDocumentationPartsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationPartsInput) String ¶
func (s GetDocumentationPartsInput) String() string
String returns the string representation
func (*GetDocumentationPartsInput) Validate ¶
func (s *GetDocumentationPartsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDocumentationPartsOutput ¶
type GetDocumentationPartsOutput struct { // The current page of elements from this collection. Items []DocumentationPart `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
The collection of documentation parts of an API.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationPart
func (GetDocumentationPartsOutput) MarshalFields ¶
func (s GetDocumentationPartsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationPartsOutput) String ¶
func (s GetDocumentationPartsOutput) String() string
String returns the string representation
type GetDocumentationPartsRequest ¶
type GetDocumentationPartsRequest struct { *aws.Request Input *GetDocumentationPartsInput Copy func(*GetDocumentationPartsInput) GetDocumentationPartsRequest }
GetDocumentationPartsRequest is the request type for the GetDocumentationParts API operation.
func (GetDocumentationPartsRequest) Send ¶
func (r GetDocumentationPartsRequest) Send(ctx context.Context) (*GetDocumentationPartsResponse, error)
Send marshals and sends the GetDocumentationParts API request.
type GetDocumentationPartsResponse ¶
type GetDocumentationPartsResponse struct { *GetDocumentationPartsOutput // contains filtered or unexported fields }
GetDocumentationPartsResponse is the response type for the GetDocumentationParts API operation.
func (*GetDocumentationPartsResponse) SDKResponseMetdata ¶
func (r *GetDocumentationPartsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDocumentationParts request.
type GetDocumentationVersionInput ¶
type GetDocumentationVersionInput struct { // [Required] The version identifier of the to-be-retrieved documentation snapshot. // // DocumentationVersion is a required field DocumentationVersion *string `location:"uri" locationName:"doc_version" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets a documentation snapshot of an API.
func (GetDocumentationVersionInput) MarshalFields ¶
func (s GetDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationVersionInput) String ¶
func (s GetDocumentationVersionInput) String() string
String returns the string representation
func (*GetDocumentationVersionInput) Validate ¶
func (s *GetDocumentationVersionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDocumentationVersionOutput ¶
type GetDocumentationVersionOutput struct { // The date when the API documentation snapshot is created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the API documentation snapshot. Description *string `locationName:"description" type:"string"` // The version identifier of the API documentation snapshot. Version *string `locationName:"version" type:"string"` // contains filtered or unexported fields }
A snapshot of the documentation of an API.
Publishing API documentation involves creating a documentation version associated with an API stage and exporting the versioned documentation to an external (e.g., OpenAPI) file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationPart, DocumentationVersions
func (GetDocumentationVersionOutput) MarshalFields ¶
func (s GetDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationVersionOutput) String ¶
func (s GetDocumentationVersionOutput) String() string
String returns the string representation
type GetDocumentationVersionRequest ¶
type GetDocumentationVersionRequest struct { *aws.Request Input *GetDocumentationVersionInput Copy func(*GetDocumentationVersionInput) GetDocumentationVersionRequest }
GetDocumentationVersionRequest is the request type for the GetDocumentationVersion API operation.
func (GetDocumentationVersionRequest) Send ¶
func (r GetDocumentationVersionRequest) Send(ctx context.Context) (*GetDocumentationVersionResponse, error)
Send marshals and sends the GetDocumentationVersion API request.
type GetDocumentationVersionResponse ¶
type GetDocumentationVersionResponse struct { *GetDocumentationVersionOutput // contains filtered or unexported fields }
GetDocumentationVersionResponse is the response type for the GetDocumentationVersion API operation.
func (*GetDocumentationVersionResponse) SDKResponseMetdata ¶
func (r *GetDocumentationVersionResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDocumentationVersion request.
type GetDocumentationVersionsInput ¶
type GetDocumentationVersionsInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets the documentation versions of an API.
func (GetDocumentationVersionsInput) MarshalFields ¶
func (s GetDocumentationVersionsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationVersionsInput) String ¶
func (s GetDocumentationVersionsInput) String() string
String returns the string representation
func (*GetDocumentationVersionsInput) Validate ¶
func (s *GetDocumentationVersionsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDocumentationVersionsOutput ¶
type GetDocumentationVersionsOutput struct { // The current page of elements from this collection. Items []DocumentationVersion `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
The collection of documentation snapshots of an API.
Use the DocumentationVersions to manage documentation snapshots associated with various API stages.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationPart, DocumentationVersion
func (GetDocumentationVersionsOutput) MarshalFields ¶
func (s GetDocumentationVersionsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDocumentationVersionsOutput) String ¶
func (s GetDocumentationVersionsOutput) String() string
String returns the string representation
type GetDocumentationVersionsRequest ¶
type GetDocumentationVersionsRequest struct { *aws.Request Input *GetDocumentationVersionsInput Copy func(*GetDocumentationVersionsInput) GetDocumentationVersionsRequest }
GetDocumentationVersionsRequest is the request type for the GetDocumentationVersions API operation.
func (GetDocumentationVersionsRequest) Send ¶
func (r GetDocumentationVersionsRequest) Send(ctx context.Context) (*GetDocumentationVersionsResponse, error)
Send marshals and sends the GetDocumentationVersions API request.
type GetDocumentationVersionsResponse ¶
type GetDocumentationVersionsResponse struct { *GetDocumentationVersionsOutput // contains filtered or unexported fields }
GetDocumentationVersionsResponse is the response type for the GetDocumentationVersions API operation.
func (*GetDocumentationVersionsResponse) SDKResponseMetdata ¶
func (r *GetDocumentationVersionsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDocumentationVersions request.
type GetDomainNameInput ¶
type GetDomainNameInput struct { // [Required] The name of the DomainName resource. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // contains filtered or unexported fields }
Request to get the name of a DomainName resource.
func (GetDomainNameInput) MarshalFields ¶
func (s GetDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDomainNameInput) String ¶
func (s GetDomainNameInput) String() string
String returns the string representation
func (*GetDomainNameInput) Validate ¶
func (s *GetDomainNameInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDomainNameOutput ¶
type GetDomainNameOutput struct { // The reference to an AWS-managed certificate that will be used by edge-optimized // endpoint for this domain name. AWS Certificate Manager is the only supported // source. CertificateArn *string `locationName:"certificateArn" type:"string"` // The name of the certificate that will be used by edge-optimized endpoint // for this domain name. CertificateName *string `locationName:"certificateName" type:"string"` // The timestamp when the certificate that was used by edge-optimized endpoint // for this domain name was uploaded. CertificateUploadDate *time.Time `locationName:"certificateUploadDate" type:"timestamp"` // The domain name of the Amazon CloudFront distribution associated with this // custom domain name for an edge-optimized endpoint. You set up this association // when adding a DNS record pointing the custom domain name to this distribution // name. For more information about CloudFront distributions, see the Amazon // CloudFront documentation (https://aws.amazon.com/documentation/cloudfront/). DistributionDomainName *string `locationName:"distributionDomainName" type:"string"` // The region-agnostic Amazon Route 53 Hosted Zone ID of the edge-optimized // endpoint. The valid value is Z2FDTNDATAQYW2 for all the regions. For more // information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). DistributionHostedZoneId *string `locationName:"distributionHostedZoneId" type:"string"` // The custom domain name as an API host name, for example, my-api.example.com. DomainName *string `locationName:"domainName" type:"string"` // The status of the DomainName migration. The valid values are AVAILABLE and // UPDATING. If the status is UPDATING, the domain cannot be modified further // until the existing operation is complete. If it is AVAILABLE, the domain // can be updated. DomainNameStatus DomainNameStatus `locationName:"domainNameStatus" type:"string" enum:"true"` // An optional text message containing detailed information about status of // the DomainName migration. DomainNameStatusMessage *string `locationName:"domainNameStatusMessage" type:"string"` // The endpoint configuration of this DomainName showing the endpoint types // of the domain name. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The reference to an AWS-managed certificate that will be used for validating // the regional domain name. AWS Certificate Manager is the only supported source. RegionalCertificateArn *string `locationName:"regionalCertificateArn" type:"string"` // The name of the certificate that will be used for validating the regional // domain name. RegionalCertificateName *string `locationName:"regionalCertificateName" type:"string"` // The domain name associated with the regional endpoint for this custom domain // name. You set up this association by adding a DNS record that points the // custom domain name to this regional domain name. The regional domain name // is returned by API Gateway when you create a regional endpoint. RegionalDomainName *string `locationName:"regionalDomainName" type:"string"` // The region-specific Amazon Route 53 Hosted Zone ID of the regional endpoint. // For more information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). RegionalHostedZoneId *string `locationName:"regionalHostedZoneId" type:"string"` // The Transport Layer Security (TLS) version + cipher suite for this DomainName. // The valid values are TLS_1_0 and TLS_1_2. SecurityPolicy SecurityPolicy `locationName:"securityPolicy" type:"string" enum:"true"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a custom domain name as a user-friendly host name of an API (RestApi).
When you deploy an API, API Gateway creates a default host name for the API. This default API host name is of the {restapi-id}.execute-api.{region}.amazonaws.com format. With the default host name, you can access the API's root resource with the URL of https://{restapi-id}.execute-api.{region}.amazonaws.com/{stage}/. When you set up a custom domain name of apis.example.com for this API, you can then access the same resource using the URL of the https://apis.examples.com/myApi, where myApi is the base path mapping (BasePathMapping) of your API under the custom domain name.
Set a Custom Host Name for an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (GetDomainNameOutput) MarshalFields ¶
func (s GetDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDomainNameOutput) String ¶
func (s GetDomainNameOutput) String() string
String returns the string representation
type GetDomainNameRequest ¶
type GetDomainNameRequest struct { *aws.Request Input *GetDomainNameInput Copy func(*GetDomainNameInput) GetDomainNameRequest }
GetDomainNameRequest is the request type for the GetDomainName API operation.
func (GetDomainNameRequest) Send ¶
func (r GetDomainNameRequest) Send(ctx context.Context) (*GetDomainNameResponse, error)
Send marshals and sends the GetDomainName API request.
type GetDomainNameResponse ¶
type GetDomainNameResponse struct { *GetDomainNameOutput // contains filtered or unexported fields }
GetDomainNameResponse is the response type for the GetDomainName API operation.
func (*GetDomainNameResponse) SDKResponseMetdata ¶
func (r *GetDomainNameResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDomainName request.
type GetDomainNamesInput ¶
type GetDomainNamesInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
Request to describe a collection of DomainName resources.
func (GetDomainNamesInput) MarshalFields ¶
func (s GetDomainNamesInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDomainNamesInput) String ¶
func (s GetDomainNamesInput) String() string
String returns the string representation
type GetDomainNamesOutput ¶
type GetDomainNamesOutput struct { // The current page of elements from this collection. Items []DomainName `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection of DomainName resources.
Use Client-Side Certificate (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (GetDomainNamesOutput) MarshalFields ¶
func (s GetDomainNamesOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetDomainNamesOutput) String ¶
func (s GetDomainNamesOutput) String() string
String returns the string representation
type GetDomainNamesPaginator ¶
GetDomainNamesPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetDomainNamesPaginator ¶
func NewGetDomainNamesPaginator(req GetDomainNamesRequest) GetDomainNamesPaginator
NewGetDomainNamesRequestPaginator returns a paginator for GetDomainNames. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetDomainNamesRequest(input) p := apigateway.NewGetDomainNamesRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetDomainNamesPaginator) CurrentPage ¶
func (p *GetDomainNamesPaginator) CurrentPage() *GetDomainNamesOutput
type GetDomainNamesRequest ¶
type GetDomainNamesRequest struct { *aws.Request Input *GetDomainNamesInput Copy func(*GetDomainNamesInput) GetDomainNamesRequest }
GetDomainNamesRequest is the request type for the GetDomainNames API operation.
func (GetDomainNamesRequest) Send ¶
func (r GetDomainNamesRequest) Send(ctx context.Context) (*GetDomainNamesResponse, error)
Send marshals and sends the GetDomainNames API request.
type GetDomainNamesResponse ¶
type GetDomainNamesResponse struct { *GetDomainNamesOutput // contains filtered or unexported fields }
GetDomainNamesResponse is the response type for the GetDomainNames API operation.
func (*GetDomainNamesResponse) SDKResponseMetdata ¶
func (r *GetDomainNamesResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetDomainNames request.
type GetExportInput ¶
type GetExportInput struct { // The content-type of the export, for example application/json. Currently application/json // and application/yaml are supported for exportType ofoas30 and swagger. This // should be specified in the Accept header for direct API requests. Accepts *string `location:"header" locationName:"Accept" type:"string"` // [Required] The type of export. Acceptable values are 'oas30' for OpenAPI // 3.0.x and 'swagger' for Swagger/OpenAPI 2.0. // // ExportType is a required field ExportType *string `location:"uri" locationName:"export_type" type:"string" required:"true"` // A key-value map of query string parameters that specify properties of the // export, depending on the requested exportType. For exportType oas30 and swagger, // any combination of the following parameters are supported: extensions='integrations' // or extensions='apigateway' will export the API with x-amazon-apigateway-integration // extensions. extensions='authorizers' will export the API with x-amazon-apigateway-authorizer // extensions. postman will export the API with Postman extensions, allowing // for import to the Postman tool Parameters map[string]string `location:"querystring" locationName:"parameters" type:"map"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The name of the Stage that will be exported. // // StageName is a required field StageName *string `location:"uri" locationName:"stage_name" type:"string" required:"true"` // contains filtered or unexported fields }
Request a new export of a RestApi for a particular Stage.
func (GetExportInput) MarshalFields ¶
func (s GetExportInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetExportInput) String ¶
func (s GetExportInput) String() string
String returns the string representation
func (*GetExportInput) Validate ¶
func (s *GetExportInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetExportOutput ¶
type GetExportOutput struct { // The binary blob response to GetExport, which contains the export. Body []byte `locationName:"body" type:"blob"` // The content-disposition header value in the HTTP response. ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"string"` // The content-type header value in the HTTP response. This will correspond // to a valid 'accept' type in the request. ContentType *string `location:"header" locationName:"Content-Type" type:"string"` // contains filtered or unexported fields }
The binary blob response to GetExport, which contains the generated SDK.
func (GetExportOutput) MarshalFields ¶
func (s GetExportOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetExportOutput) String ¶
func (s GetExportOutput) String() string
String returns the string representation
type GetExportRequest ¶
type GetExportRequest struct { *aws.Request Input *GetExportInput Copy func(*GetExportInput) GetExportRequest }
GetExportRequest is the request type for the GetExport API operation.
func (GetExportRequest) Send ¶
func (r GetExportRequest) Send(ctx context.Context) (*GetExportResponse, error)
Send marshals and sends the GetExport API request.
type GetExportResponse ¶
type GetExportResponse struct { *GetExportOutput // contains filtered or unexported fields }
GetExportResponse is the response type for the GetExport API operation.
func (*GetExportResponse) SDKResponseMetdata ¶
func (r *GetExportResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetExport request.
type GetGatewayResponseInput ¶
type GetGatewayResponseInput struct { // [Required] // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE // // ResponseType is a required field ResponseType GatewayResponseType `location:"uri" locationName:"response_type" type:"string" required:"true" enum:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets a GatewayResponse of a specified response type on the given RestApi.
func (GetGatewayResponseInput) MarshalFields ¶
func (s GetGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetGatewayResponseInput) String ¶
func (s GetGatewayResponseInput) String() string
String returns the string representation
func (*GetGatewayResponseInput) Validate ¶
func (s *GetGatewayResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetGatewayResponseOutput ¶
type GetGatewayResponseOutput struct { // A Boolean flag to indicate whether this GatewayResponse is the default gateway // response (true) or not (false). A default gateway response is one generated // by API Gateway without any customization by an API developer. DefaultResponse *bool `locationName:"defaultResponse" type:"boolean"` // Response parameters (paths, query strings and headers) of the GatewayResponse // as a string-to-string map of key-value pairs. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Response templates of the GatewayResponse as a string-to-string map of key-value // pairs. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE ResponseType GatewayResponseType `locationName:"responseType" type:"string" enum:"true"` // The HTTP status code for this GatewayResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
A gateway response of a given response type and status code, with optional response parameters and mapping templates.
For more information about valid gateway response types, see Gateway Response Types Supported by API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html)
Example: Get a Gateway Response of a given response type
Request
This example shows how to get a gateway response of the MISSING_AUTHENTICATION_TOKEN type.
GET /restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN HTTP/1.1 Host: beta-apigateway.us-east-1.amazonaws.com Content-Type: application/json X-Amz-Date: 20170503T202516Z Authorization: AWS4-HMAC-SHA256 Credential={access-key-id}/20170503/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=1b52460e3159c1a26cff29093855d50ea141c1c5b937528fecaf60f51129697a Cache-Control: no-cache Postman-Token: 3b2a1ce9-c848-2e26-2e2f-9c2caefbed45
The response type is specified as a URL path.
Response
The successful operation returns the 200 OK status code and a payload similar to the following:
{ "_links": { "curies": { "href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-gatewayresponse-{rel}.html", "name": "gatewayresponse", "templated": true }, "self": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:delete": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" } }, "defaultResponse": false, "responseParameters": { "gatewayresponse.header.x-request-path": "method.request.path.petId", "gatewayresponse.header.Access-Control-Allow-Origin": "'a.b.c'", "gatewayresponse.header.x-request-query": "method.request.querystring.q", "gatewayresponse.header.x-request-header": "method.request.header.Accept" }, "responseTemplates": { "application/json": "{\n \"message\": $context.error.messageString,\n \"type\": \"$context.error.responseType\",\n \"stage\": \"$context.stage\",\n \"resourcePath\": \"$context.resourcePath\",\n \"stageVariables.a\": \"$stageVariables.a\",\n \"statusCode\": \"'404'\"\n}" }, "responseType": "MISSING_AUTHENTICATION_TOKEN", "statusCode": "404" }
Customize Gateway Responses (https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html)
func (GetGatewayResponseOutput) MarshalFields ¶
func (s GetGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetGatewayResponseOutput) String ¶
func (s GetGatewayResponseOutput) String() string
String returns the string representation
type GetGatewayResponseRequest ¶
type GetGatewayResponseRequest struct { *aws.Request Input *GetGatewayResponseInput Copy func(*GetGatewayResponseInput) GetGatewayResponseRequest }
GetGatewayResponseRequest is the request type for the GetGatewayResponse API operation.
func (GetGatewayResponseRequest) Send ¶
func (r GetGatewayResponseRequest) Send(ctx context.Context) (*GetGatewayResponseResponse, error)
Send marshals and sends the GetGatewayResponse API request.
type GetGatewayResponseResponse ¶
type GetGatewayResponseResponse struct { *GetGatewayResponseOutput // contains filtered or unexported fields }
GetGatewayResponseResponse is the response type for the GetGatewayResponse API operation.
func (*GetGatewayResponseResponse) SDKResponseMetdata ¶
func (r *GetGatewayResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetGatewayResponse request.
type GetGatewayResponsesInput ¶
type GetGatewayResponsesInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. The GatewayResponses collection does not support // pagination and the limit does not apply here. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. The GatewayResponse // collection does not support pagination and the position does not apply here. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.
func (GetGatewayResponsesInput) MarshalFields ¶
func (s GetGatewayResponsesInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetGatewayResponsesInput) String ¶
func (s GetGatewayResponsesInput) String() string
String returns the string representation
func (*GetGatewayResponsesInput) Validate ¶
func (s *GetGatewayResponsesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetGatewayResponsesOutput ¶
type GetGatewayResponsesOutput struct { // Returns the entire collection, because of no pagination support. Items []GatewayResponse `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
The collection of the GatewayResponse instances of a RestApi as a responseType-to-GatewayResponse object map of key-value pairs. As such, pagination is not supported for querying this collection.
For more information about valid gateway response types, see Gateway Response Types Supported by API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html)
Example: Get the collection of gateway responses of an API
Request
This example request shows how to retrieve the GatewayResponses collection from an API.
GET /restapis/o81lxisefl/gatewayresponses HTTP/1.1 Host: beta-apigateway.us-east-1.amazonaws.com Content-Type: application/json X-Amz-Date: 20170503T220604Z Authorization: AWS4-HMAC-SHA256 Credential={access-key-id}/20170503/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=59b42fe54a76a5de8adf2c67baa6d39206f8e9ad49a1d77ccc6a5da3103a398a Cache-Control: no-cache Postman-Token: 5637af27-dc29-fc5c-9dfe-0645d52cb515
Response
The successful operation returns the 200 OK status code and a payload similar to the following:
{ "_links": { "curies": { "href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-gatewayresponse-{rel}.html", "name": "gatewayresponse", "templated": true }, "self": { "href": "/restapis/o81lxisefl/gatewayresponses" }, "first": { "href": "/restapis/o81lxisefl/gatewayresponses" }, "gatewayresponse:by-type": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "item": [ { "href": "/restapis/o81lxisefl/gatewayresponses/INTEGRATION_FAILURE" }, { "href": "/restapis/o81lxisefl/gatewayresponses/RESOURCE_NOT_FOUND" }, { "href": "/restapis/o81lxisefl/gatewayresponses/REQUEST_TOO_LARGE" }, { "href": "/restapis/o81lxisefl/gatewayresponses/THROTTLED" }, { "href": "/restapis/o81lxisefl/gatewayresponses/UNSUPPORTED_MEDIA_TYPE" }, { "href": "/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_CONFIGURATION_ERROR" }, { "href": "/restapis/o81lxisefl/gatewayresponses/DEFAULT_5XX" }, { "href": "/restapis/o81lxisefl/gatewayresponses/DEFAULT_4XX" }, { "href": "/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_PARAMETERS" }, { "href": "/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_BODY" }, { "href": "/restapis/o81lxisefl/gatewayresponses/EXPIRED_TOKEN" }, { "href": "/restapis/o81lxisefl/gatewayresponses/ACCESS_DENIED" }, { "href": "/restapis/o81lxisefl/gatewayresponses/INVALID_API_KEY" }, { "href": "/restapis/o81lxisefl/gatewayresponses/UNAUTHORIZED" }, { "href": "/restapis/o81lxisefl/gatewayresponses/API_CONFIGURATION_ERROR" }, { "href": "/restapis/o81lxisefl/gatewayresponses/QUOTA_EXCEEDED" }, { "href": "/restapis/o81lxisefl/gatewayresponses/INTEGRATION_TIMEOUT" }, { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, { "href": "/restapis/o81lxisefl/gatewayresponses/INVALID_SIGNATURE" }, { "href": "/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_FAILURE" } ] }, "_embedded": { "item": [ { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/INTEGRATION_FAILURE" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/INTEGRATION_FAILURE" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "INTEGRATION_FAILURE", "statusCode": "504" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/RESOURCE_NOT_FOUND" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/RESOURCE_NOT_FOUND" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "RESOURCE_NOT_FOUND", "statusCode": "404" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/REQUEST_TOO_LARGE" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/REQUEST_TOO_LARGE" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "REQUEST_TOO_LARGE", "statusCode": "413" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/THROTTLED" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/THROTTLED" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "THROTTLED", "statusCode": "429" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/UNSUPPORTED_MEDIA_TYPE" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/UNSUPPORTED_MEDIA_TYPE" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "UNSUPPORTED_MEDIA_TYPE", "statusCode": "415" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_CONFIGURATION_ERROR" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_CONFIGURATION_ERROR" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "AUTHORIZER_CONFIGURATION_ERROR", "statusCode": "500" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/DEFAULT_5XX" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/DEFAULT_5XX" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "DEFAULT_5XX" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/DEFAULT_4XX" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/DEFAULT_4XX" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "DEFAULT_4XX" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_PARAMETERS" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_PARAMETERS" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "BAD_REQUEST_PARAMETERS", "statusCode": "400" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_BODY" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_BODY" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "BAD_REQUEST_BODY", "statusCode": "400" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/EXPIRED_TOKEN" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/EXPIRED_TOKEN" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "EXPIRED_TOKEN", "statusCode": "403" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/ACCESS_DENIED" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/ACCESS_DENIED" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "ACCESS_DENIED", "statusCode": "403" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/INVALID_API_KEY" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/INVALID_API_KEY" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "INVALID_API_KEY", "statusCode": "403" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/UNAUTHORIZED" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/UNAUTHORIZED" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "UNAUTHORIZED", "statusCode": "401" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/API_CONFIGURATION_ERROR" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/API_CONFIGURATION_ERROR" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "API_CONFIGURATION_ERROR", "statusCode": "500" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/QUOTA_EXCEEDED" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/QUOTA_EXCEEDED" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "QUOTA_EXCEEDED", "statusCode": "429" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/INTEGRATION_TIMEOUT" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/INTEGRATION_TIMEOUT" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "INTEGRATION_TIMEOUT", "statusCode": "504" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "MISSING_AUTHENTICATION_TOKEN", "statusCode": "403" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/INVALID_SIGNATURE" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/INVALID_SIGNATURE" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "INVALID_SIGNATURE", "statusCode": "403" }, { "_links": { "self": { "href": "/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_FAILURE" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_FAILURE" } }, "defaultResponse": true, "responseParameters": {}, "responseTemplates": { "application/json": "{\"message\":$context.error.messageString}" }, "responseType": "AUTHORIZER_FAILURE", "statusCode": "500" } ] } }
Customize Gateway Responses (https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html)
func (GetGatewayResponsesOutput) MarshalFields ¶
func (s GetGatewayResponsesOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetGatewayResponsesOutput) String ¶
func (s GetGatewayResponsesOutput) String() string
String returns the string representation
type GetGatewayResponsesRequest ¶
type GetGatewayResponsesRequest struct { *aws.Request Input *GetGatewayResponsesInput Copy func(*GetGatewayResponsesInput) GetGatewayResponsesRequest }
GetGatewayResponsesRequest is the request type for the GetGatewayResponses API operation.
func (GetGatewayResponsesRequest) Send ¶
func (r GetGatewayResponsesRequest) Send(ctx context.Context) (*GetGatewayResponsesResponse, error)
Send marshals and sends the GetGatewayResponses API request.
type GetGatewayResponsesResponse ¶
type GetGatewayResponsesResponse struct { *GetGatewayResponsesOutput // contains filtered or unexported fields }
GetGatewayResponsesResponse is the response type for the GetGatewayResponses API operation.
func (*GetGatewayResponsesResponse) SDKResponseMetdata ¶
func (r *GetGatewayResponsesResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetGatewayResponses request.
type GetIntegrationInput ¶
type GetIntegrationInput struct { // [Required] Specifies a get integration request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] Specifies a get integration request's resource identifier // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Represents a request to get the integration configuration.
func (GetIntegrationInput) MarshalFields ¶
func (s GetIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetIntegrationInput) String ¶
func (s GetIntegrationInput) String() string
String returns the string representation
func (*GetIntegrationInput) Validate ¶
func (s *GetIntegrationInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetIntegrationOutput ¶
type GetIntegrationOutput struct { // A list of request parameters whose values API Gateway caches. To be valid // values for cacheKeyParameters, these parameters must also be specified for // Method requestParameters. CacheKeyParameters []string `locationName:"cacheKeyParameters" type:"list"` // An API-specific tag group of related cached parameters. To be valid values // for cacheKeyParameters, these parameters must also be specified for Method // requestParameters. CacheNamespace *string `locationName:"cacheNamespace" type:"string"` // The (id (https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id)) // of the VpcLink used for the integration when connectionType=VPC_LINK and // undefined, otherwise. ConnectionId *string `locationName:"connectionId" type:"string"` // The type of the network connection to the integration endpoint. The valid // value is INTERNET for connections through the public routable internet or // VPC_LINK for private connections between API Gateway and a network load balancer // in a VPC. The default value is INTERNET. ConnectionType ConnectionType `locationName:"connectionType" type:"string" enum:"true"` // Specifies how to handle request payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a request payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a request payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the request payload will be passed through // from the method request to integration request without modification, provided // that the passthroughBehavior is configured to support payload pass-through. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // Specifies the credentials required for the integration, if any. For AWS integrations, // three options are available. To specify an IAM Role for API Gateway to assume, // use the role's Amazon Resource Name (ARN). To require that the caller's identity // be passed through from the request, specify the string arn:aws:iam::\*:user/\*. // To use resource-based permissions on supported AWS services, specify null. Credentials *string `locationName:"credentials" type:"string"` // Specifies the integration's HTTP method type. HttpMethod *string `locationName:"httpMethod" type:"string"` // Specifies the integration's responses. // // Example: Get integration responses of a method // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200 // HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // X-Amz-Date: 20160607T191449Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160607/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns 200 OK status and a payload as follows: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } // // Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html) IntegrationResponses map[string]IntegrationResponse `locationName:"integrationResponses" type:"map"` // Specifies how the method request body of an unmapped content type will be // passed through the integration request to the back end without transformation. // A content type is unmapped if no mapping template is defined in the integration // or the content type does not match any of the mapped content types, as specified // in requestTemplates. The valid value is one of the following: // // * WHEN_NO_MATCH: passes the method request body through the integration // request to the back end without transformation when the method request // content type does not match any content type associated with the mapping // templates defined in the integration request. // // * WHEN_NO_TEMPLATES: passes the method request body through the integration // request to the back end without transformation when no mapping template // is defined in the integration request. If a template is defined when this // option is selected, the method request of an unmapped content-type will // be rejected with an HTTP 415 Unsupported Media Type response. // // * NEVER: rejects the method request with an HTTP 415 Unsupported Media // Type response when either the method request content type does not match // any content type associated with the mapping templates defined in the // integration request or no mapping template is defined in the integration // request. PassthroughBehavior *string `locationName:"passthroughBehavior" type:"string"` // A key-value map specifying request parameters that are passed from the method // request to the back end. The key is an integration request parameter name // and the associated value is a method request parameter value or static value // that must be enclosed within single quotes and pre-encoded as required by // the back end. The method request parameter value must match the pattern of // method.request.{location}.{name}, where location is querystring, path, or // header and name must be a valid and unique method request parameter name. RequestParameters map[string]string `locationName:"requestParameters" type:"map"` // Represents a map of Velocity templates that are applied on the request payload // based on the value of the Content-Type header sent by the client. The content // type value is the key in this map, and the template (as a String) is the // value. RequestTemplates map[string]string `locationName:"requestTemplates" type:"map"` // Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 // milliseconds or 29 seconds. TimeoutInMillis *int64 `locationName:"timeoutInMillis" type:"integer"` // Specifies an API method integration type. The valid value is one of the following: // // * AWS: for integrating the API method request with an AWS service action, // including the Lambda function-invoking action. With the Lambda function-invoking // action, this is referred to as the Lambda custom integration. With any // other AWS service action, this is known as AWS integration. // // * AWS_PROXY: for integrating the API method request with the Lambda function-invoking // action with the client request passed through as-is. This integration // is also referred to as the Lambda proxy integration. // // * HTTP: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC. This integration is also // referred to as the HTTP custom integration. // // * HTTP_PROXY: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC, with the client request // passed through as-is. This is also referred to as the HTTP proxy integration. // // * MOCK: for integrating the API method request with API Gateway as a "loop-back" // endpoint without invoking any backend. // // For the HTTP and HTTP proxy integrations, each integration can specify a // protocol (http/https), port and path. Standard 80 and 443 ports are supported // as well as custom ports above 1024. An HTTP or HTTP proxy integration with // a connectionType of VPC_LINK is referred to as a private integration and // uses a VpcLink to connect API Gateway to a network load balancer of a VPC. Type IntegrationType `locationName:"type" type:"string" enum:"true"` // Specifies Uniform Resource Identifier (URI) of the integration endpoint. // // * For HTTP or HTTP_PROXY integrations, the URI must be a fully formed, // encoded HTTP(S) URL according to the RFC-3986 specification (https://en.wikipedia.org/wiki/Uniform_Resource_Identifier), // for either standard integration, where connectionType is not VPC_LINK, // or private integration, where connectionType is VPC_LINK. For a private // HTTP integration, the URI is not used for routing. // // * For AWS or AWS_PROXY integrations, the URI is of the form arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api}. // Here, {Region} is the API Gateway region (e.g., us-east-1); {service} // is the name of the integrated AWS service (e.g., s3); and {subdomain} // is a designated subdomain supported by certain AWS service for fast host-name // lookup. action can be used for an AWS service action-based API, using // an Action={name}&{p1}={v1}&p2={v2}... query string. The ensuing {service_api} // refers to a supported action {name} plus any required input parameters. // Alternatively, path can be used for an AWS service path-based API. The // ensuing service_api refers to the path to an AWS service resource, including // the region of the integrated AWS service, if applicable. For example, // for integration with the S3 API of GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html), // the uri can be either arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} // or arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key} Uri *string `locationName:"uri" type:"string"` // contains filtered or unexported fields }
Represents an HTTP, HTTP_PROXY, AWS, AWS_PROXY, or Mock integration.
In the API Gateway console, the built-in Lambda integration is an AWS integration.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (GetIntegrationOutput) MarshalFields ¶
func (s GetIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetIntegrationOutput) String ¶
func (s GetIntegrationOutput) String() string
String returns the string representation
type GetIntegrationRequest ¶
type GetIntegrationRequest struct { *aws.Request Input *GetIntegrationInput Copy func(*GetIntegrationInput) GetIntegrationRequest }
GetIntegrationRequest is the request type for the GetIntegration API operation.
func (GetIntegrationRequest) Send ¶
func (r GetIntegrationRequest) Send(ctx context.Context) (*GetIntegrationResponse, error)
Send marshals and sends the GetIntegration API request.
type GetIntegrationResponse ¶
type GetIntegrationResponse struct { *GetIntegrationOutput // contains filtered or unexported fields }
GetIntegrationResponse is the response type for the GetIntegration API operation.
func (*GetIntegrationResponse) SDKResponseMetdata ¶
func (r *GetIntegrationResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetIntegration request.
type GetIntegrationResponseInput ¶
type GetIntegrationResponseInput struct { // [Required] Specifies a get integration response request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] Specifies a get integration response request's resource identifier. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] Specifies a get integration response request's status code. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
Represents a get integration response request.
func (GetIntegrationResponseInput) MarshalFields ¶
func (s GetIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetIntegrationResponseInput) String ¶
func (s GetIntegrationResponseInput) String() string
String returns the string representation
func (*GetIntegrationResponseInput) Validate ¶
func (s *GetIntegrationResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetIntegrationResponseOutput ¶
type GetIntegrationResponseOutput struct { // Specifies how to handle response payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a response payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the response payload will be passed through // from the integration response to the method response without modification. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // A key-value map specifying response parameters that are passed to the method // response from the back end. The key is a method response header parameter // name and the mapped value is an integration response header value, a static // value enclosed within a pair of single quotes, or a JSON expression from // the integration response body. The mapping key must match the pattern of // method.response.header.{name}, where name is a valid and unique header name. // The mapped non-static value must match the pattern of integration.response.header.{name} // or integration.response.body.{JSON-expression}, where name is a valid and // unique response header name and JSON-expression is a valid JSON expression // without the $ prefix. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Specifies the templates used to transform the integration response body. // Response templates are represented as a key/value map, with a content-type // as the key and a template as the value. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // Specifies the regular expression (regex) pattern used to choose an integration // response based on the response from the back end. For example, if the success // response returns nothing and the error response returns some string, you // could use the .+ regex to match error response. However, make sure that the // error response does not contain any newline (\n) character in such cases. // If the back end is an AWS Lambda function, the AWS Lambda function error // header is matched. For all other HTTP and AWS back ends, the HTTP status // code is matched. SelectionPattern *string `locationName:"selectionPattern" type:"string"` // Specifies the status code that is used to map the integration response to // an existing MethodResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents an integration response. The status code must map to an existing MethodResponse, and parameters and templates can be used to transform the back-end response.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (GetIntegrationResponseOutput) MarshalFields ¶
func (s GetIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetIntegrationResponseOutput) String ¶
func (s GetIntegrationResponseOutput) String() string
String returns the string representation
type GetIntegrationResponseRequest ¶
type GetIntegrationResponseRequest struct { *aws.Request Input *GetIntegrationResponseInput Copy func(*GetIntegrationResponseInput) GetIntegrationResponseRequest }
GetIntegrationResponseRequest is the request type for the GetIntegrationResponse API operation.
func (GetIntegrationResponseRequest) Send ¶
func (r GetIntegrationResponseRequest) Send(ctx context.Context) (*GetIntegrationResponseResponse, error)
Send marshals and sends the GetIntegrationResponse API request.
type GetIntegrationResponseResponse ¶
type GetIntegrationResponseResponse struct { *GetIntegrationResponseOutput // contains filtered or unexported fields }
GetIntegrationResponseResponse is the response type for the GetIntegrationResponse API operation.
func (*GetIntegrationResponseResponse) SDKResponseMetdata ¶
func (r *GetIntegrationResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetIntegrationResponse request.
type GetMethodInput ¶
type GetMethodInput struct { // [Required] Specifies the method request's HTTP method type. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] The Resource identifier for the Method resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to describe an existing Method resource.
func (GetMethodInput) MarshalFields ¶
func (s GetMethodInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetMethodInput) String ¶
func (s GetMethodInput) String() string
String returns the string representation
func (*GetMethodInput) Validate ¶
func (s *GetMethodInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetMethodOutput ¶
type GetMethodOutput struct { // A boolean flag specifying whether a valid ApiKey is required to invoke this // method. ApiKeyRequired *bool `locationName:"apiKeyRequired" type:"boolean"` // A list of authorization scopes configured on the method. The scopes are used // with a COGNITO_USER_POOLS authorizer to authorize the method invocation. // The authorization works by matching the method scopes against the scopes // parsed from the access token in the incoming request. The method invocation // is authorized if any method scopes matches a claimed scope in the access // token. Otherwise, the invocation is not authorized. When the method scope // is configured, the client must provide an access token instead of an identity // token for authorization purposes. AuthorizationScopes []string `locationName:"authorizationScopes" type:"list"` // The method's authorization type. Valid values are NONE for open access, AWS_IAM // for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS // for using a Cognito user pool. AuthorizationType *string `locationName:"authorizationType" type:"string"` // The identifier of an Authorizer to use on this method. The authorizationType // must be CUSTOM. AuthorizerId *string `locationName:"authorizerId" type:"string"` // The method's HTTP verb. HttpMethod *string `locationName:"httpMethod" type:"string"` // Gets the method's integration responsible for passing the client-submitted // request to the back end and performing necessary transformations to make // the request compliant with the back end. // // Example: // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T213210Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true } ], "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" }, "integration:delete": // { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "0cjtch", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestTemplates": { "application/json": // "{\n \"a\": \"$input.params('operand1')\",\n \"b\": \"$input.params('operand2')\", // \n \"op\": \"$input.params('operator')\" \n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-west-2:lambda:path//2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:Calc/invocations", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.operator": "integration.response.body.op", // "method.response.header.operand_2": "integration.response.body.b", "method.response.header.operand_1": // "integration.response.body.a" }, "responseTemplates": { "application/json": // "#set($res = $input.path('$'))\n{\n \"result\": \"$res.a, $res.b, $res.op // => $res.c\",\n \"a\" : \"$res.a\",\n \"b\" : \"$res.b\",\n \"op\" : \"$res.op\",\n // \"c\" : \"$res.c\"\n}" }, "selectionPattern": "", "statusCode": "200" } // } } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-integration.html) MethodIntegration *Integration `locationName:"methodIntegration" type:"structure"` // Gets a method response associated with a given HTTP status code. // // The collection of method responses are encapsulated in a key-value map, where // the key is a response's HTTP status code and the value is a MethodResponse // resource that specifies the response returned to the caller from the back // end through the integration response. // // Example: Get a 200 OK response of a GET method // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200 HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T215008Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200", // "title": "200" }, "methodresponse:delete": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.operator": false, "method.response.header.operand_2": // false, "method.response.header.operand_1": false }, "statusCode": "200" // } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-method-response.html) MethodResponses map[string]MethodResponse `locationName:"methodResponses" type:"map"` // A human-friendly operation identifier for the method. For example, you can // assign the operationName of ListPets for the GET /pets method in the PetStore // example. OperationName *string `locationName:"operationName" type:"string"` // A key-value map specifying data schemas, represented by Model resources, // (as the mapped value) of the request payloads of given content types (as // the mapping key). RequestModels map[string]string `locationName:"requestModels" type:"map"` // A key-value map defining required or optional method request parameters that // can be accepted by API Gateway. A key is a method request parameter name // matching the pattern of method.request.{location}.{name}, where location // is querystring, path, or header and name is a valid and unique parameter // name. The value associated with the key is a Boolean flag indicating whether // the parameter is required (true) or optional (false). The method request // parameter names defined here are available in Integration to be mapped to // integration request parameters or templates. RequestParameters map[string]bool `locationName:"requestParameters" type:"map"` // The identifier of a RequestValidator for request validation. RequestValidatorId *string `locationName:"requestValidatorId" type:"string"` // contains filtered or unexported fields }
Represents a client-facing interface by which the client calls the API to access back-end resources. A Method resource is integrated with an Integration resource. Both consist of a request and one or more responses. The method request takes the client input that is passed to the back end through the integration request. A method response returns the output from the back end to the client through an integration response. A method request is embodied in a Method resource, whereas an integration request is embodied in an Integration resource. On the other hand, a method response is represented by a MethodResponse resource, whereas an integration response is represented by an IntegrationResponse resource.
Example: Retrive the GET method on a specified resource
Request
The following example request retrieves the information about the GET method on an API resource (3kzxbg5sa2) of an API (fugvjdxtri).
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T210259Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns a 200 OK status code and a payload similar to the following:
{ "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", "templated": true } }, "apiKeyRequired": true, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": { "integration:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E\")" }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" } } }
In the example above, the response template for the 200 OK response maps the JSON output from the ListStreams action in the back end to an XML output. The mapping template is URL-encoded as %3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E and the output is decoded using the $util.urlDecode() (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#util-templat-reference) helper function.
MethodResponse, Integration, IntegrationResponse, Resource, Set up an API's method (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-method-settings.html)
func (GetMethodOutput) MarshalFields ¶
func (s GetMethodOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetMethodOutput) String ¶
func (s GetMethodOutput) String() string
String returns the string representation
type GetMethodRequest ¶
type GetMethodRequest struct { *aws.Request Input *GetMethodInput Copy func(*GetMethodInput) GetMethodRequest }
GetMethodRequest is the request type for the GetMethod API operation.
func (GetMethodRequest) Send ¶
func (r GetMethodRequest) Send(ctx context.Context) (*GetMethodResponse, error)
Send marshals and sends the GetMethod API request.
type GetMethodResponse ¶
type GetMethodResponse struct { *GetMethodOutput // contains filtered or unexported fields }
GetMethodResponse is the response type for the GetMethod API operation.
func (*GetMethodResponse) SDKResponseMetdata ¶
func (r *GetMethodResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetMethod request.
type GetMethodResponseInput ¶
type GetMethodResponseInput struct { // [Required] The HTTP verb of the Method resource. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] The Resource identifier for the MethodResponse resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The status code for the MethodResponse resource. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
Request to describe a MethodResponse resource.
func (GetMethodResponseInput) MarshalFields ¶
func (s GetMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetMethodResponseInput) String ¶
func (s GetMethodResponseInput) String() string
String returns the string representation
func (*GetMethodResponseInput) Validate ¶
func (s *GetMethodResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetMethodResponseOutput ¶
type GetMethodResponseOutput struct { // Specifies the Model resources used for the response's content-type. Response // models are represented as a key/value map, with a content-type as the key // and a Model name as the value. ResponseModels map[string]string `locationName:"responseModels" type:"map"` // A key-value map specifying required or optional response parameters that // API Gateway can send back to the caller. A key defines a method response // header and the value specifies whether the associated method response header // is required or not. The expression of the key must match the pattern method.response.header.{name}, // where name is a valid and unique header name. API Gateway passes certain // integration response data to the method response headers specified here according // to the mapping you prescribe in the API's IntegrationResponse. The integration // response data that can be mapped include an integration response header expressed // in integration.response.header.{name}, a static value enclosed within a pair // of single quotes (e.g., 'application/json'), or a JSON expression from the // back-end response payload in the form of integration.response.body.{JSON-expression}, // where JSON-expression is a valid JSON expression without the $ prefix.) ResponseParameters map[string]bool `locationName:"responseParameters" type:"map"` // The method response's status code. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents a method response of a given HTTP status code returned to the client. The method response is passed from the back end through the associated integration response that can be transformed using a mapping template.
Example: A MethodResponse instance of an API
Request
The example request retrieves a MethodResponse of the 200 status code.
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T222952Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns 200 OK status and a payload as follows:
{ "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" }
Method, IntegrationResponse, Integration Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (GetMethodResponseOutput) MarshalFields ¶
func (s GetMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetMethodResponseOutput) String ¶
func (s GetMethodResponseOutput) String() string
String returns the string representation
type GetMethodResponseRequest ¶
type GetMethodResponseRequest struct { *aws.Request Input *GetMethodResponseInput Copy func(*GetMethodResponseInput) GetMethodResponseRequest }
GetMethodResponseRequest is the request type for the GetMethodResponse API operation.
func (GetMethodResponseRequest) Send ¶
func (r GetMethodResponseRequest) Send(ctx context.Context) (*GetMethodResponseResponse, error)
Send marshals and sends the GetMethodResponse API request.
type GetMethodResponseResponse ¶
type GetMethodResponseResponse struct { *GetMethodResponseOutput // contains filtered or unexported fields }
GetMethodResponseResponse is the response type for the GetMethodResponse API operation.
func (*GetMethodResponseResponse) SDKResponseMetdata ¶
func (r *GetMethodResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetMethodResponse request.
type GetModelInput ¶
type GetModelInput struct { // A query parameter of a Boolean value to resolve (true) all external model // references and returns a flattened model schema or not (false) The default // is false. Flatten *bool `location:"querystring" locationName:"flatten" type:"boolean"` // [Required] The name of the model as an identifier. // // ModelName is a required field ModelName *string `location:"uri" locationName:"model_name" type:"string" required:"true"` // [Required] The RestApi identifier under which the Model exists. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to list information about a model in an existing RestApi resource.
func (GetModelInput) MarshalFields ¶
func (s GetModelInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetModelInput) String ¶
func (s GetModelInput) String() string
String returns the string representation
func (*GetModelInput) Validate ¶
func (s *GetModelInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetModelOutput ¶
type GetModelOutput struct { // The content-type for the model. ContentType *string `locationName:"contentType" type:"string"` // The description of the model. Description *string `locationName:"description" type:"string"` // The identifier for the model resource. Id *string `locationName:"id" type:"string"` // The name of the model. Must be an alphanumeric string. Name *string `locationName:"name" type:"string"` // The schema for the model. For application/json models, this should be JSON // schema draft 4 (https://tools.ietf.org/html/draft-zyp-json-schema-04) model. // Do not include "\*/" characters in the description of any properties because // such "\*/" characters may be interpreted as the closing marker for comments // in some languages, such as Java or JavaScript, causing the installation of // your API's SDK generated by API Gateway to fail. Schema *string `locationName:"schema" type:"string"` // contains filtered or unexported fields }
Represents the data structure of a method's request or response payload.
A request model defines the data structure of the client-supplied request payload. A response model defines the data structure of the response payload returned by the back end. Although not required, models are useful for mapping payloads between the front end and back end.
A model is used for generating an API's SDK, validating the input request body, and creating a skeletal mapping template.
Method, MethodResponse, Models and Mappings (https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html)
func (GetModelOutput) MarshalFields ¶
func (s GetModelOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetModelOutput) String ¶
func (s GetModelOutput) String() string
String returns the string representation
type GetModelRequest ¶
type GetModelRequest struct { *aws.Request Input *GetModelInput Copy func(*GetModelInput) GetModelRequest }
GetModelRequest is the request type for the GetModel API operation.
func (GetModelRequest) Send ¶
func (r GetModelRequest) Send(ctx context.Context) (*GetModelResponse, error)
Send marshals and sends the GetModel API request.
type GetModelResponse ¶
type GetModelResponse struct { *GetModelOutput // contains filtered or unexported fields }
GetModelResponse is the response type for the GetModel API operation.
func (*GetModelResponse) SDKResponseMetdata ¶
func (r *GetModelResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetModel request.
type GetModelTemplateInput ¶
type GetModelTemplateInput struct { // [Required] The name of the model for which to generate a template. // // ModelName is a required field ModelName *string `location:"uri" locationName:"model_name" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to generate a sample mapping template used to transform the payload.
func (GetModelTemplateInput) MarshalFields ¶
func (s GetModelTemplateInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetModelTemplateInput) String ¶
func (s GetModelTemplateInput) String() string
String returns the string representation
func (*GetModelTemplateInput) Validate ¶
func (s *GetModelTemplateInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetModelTemplateOutput ¶
type GetModelTemplateOutput struct { // The Apache Velocity Template Language (VTL) (https://velocity.apache.org/engine/devel/vtl-reference-guide.html) // template content used for the template resource. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
Represents a mapping template used to transform a payload.
Mapping Templates (https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html#models-mappings-mappings)
func (GetModelTemplateOutput) MarshalFields ¶
func (s GetModelTemplateOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetModelTemplateOutput) String ¶
func (s GetModelTemplateOutput) String() string
String returns the string representation
type GetModelTemplateRequest ¶
type GetModelTemplateRequest struct { *aws.Request Input *GetModelTemplateInput Copy func(*GetModelTemplateInput) GetModelTemplateRequest }
GetModelTemplateRequest is the request type for the GetModelTemplate API operation.
func (GetModelTemplateRequest) Send ¶
func (r GetModelTemplateRequest) Send(ctx context.Context) (*GetModelTemplateResponse, error)
Send marshals and sends the GetModelTemplate API request.
type GetModelTemplateResponse ¶
type GetModelTemplateResponse struct { *GetModelTemplateOutput // contains filtered or unexported fields }
GetModelTemplateResponse is the response type for the GetModelTemplate API operation.
func (*GetModelTemplateResponse) SDKResponseMetdata ¶
func (r *GetModelTemplateResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetModelTemplate request.
type GetModelsInput ¶
type GetModelsInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to list existing Models defined for a RestApi resource.
func (GetModelsInput) MarshalFields ¶
func (s GetModelsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetModelsInput) String ¶
func (s GetModelsInput) String() string
String returns the string representation
func (*GetModelsInput) Validate ¶
func (s *GetModelsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetModelsOutput ¶
type GetModelsOutput struct { // The current page of elements from this collection. Items []Model `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection of Model resources.
Method, MethodResponse, Models and Mappings (https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html)
func (GetModelsOutput) MarshalFields ¶
func (s GetModelsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetModelsOutput) String ¶
func (s GetModelsOutput) String() string
String returns the string representation
type GetModelsPaginator ¶
GetModelsPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetModelsPaginator ¶
func NewGetModelsPaginator(req GetModelsRequest) GetModelsPaginator
NewGetModelsRequestPaginator returns a paginator for GetModels. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetModelsRequest(input) p := apigateway.NewGetModelsRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetModelsPaginator) CurrentPage ¶
func (p *GetModelsPaginator) CurrentPage() *GetModelsOutput
type GetModelsRequest ¶
type GetModelsRequest struct { *aws.Request Input *GetModelsInput Copy func(*GetModelsInput) GetModelsRequest }
GetModelsRequest is the request type for the GetModels API operation.
func (GetModelsRequest) Send ¶
func (r GetModelsRequest) Send(ctx context.Context) (*GetModelsResponse, error)
Send marshals and sends the GetModels API request.
type GetModelsResponse ¶
type GetModelsResponse struct { *GetModelsOutput // contains filtered or unexported fields }
GetModelsResponse is the response type for the GetModels API operation.
func (*GetModelsResponse) SDKResponseMetdata ¶
func (r *GetModelsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetModels request.
type GetRequestValidatorInput ¶
type GetRequestValidatorInput struct { // [Required] The identifier of the RequestValidator to be retrieved. // // RequestValidatorId is a required field RequestValidatorId *string `location:"uri" locationName:"requestvalidator_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets a RequestValidator of a given RestApi.
func (GetRequestValidatorInput) MarshalFields ¶
func (s GetRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRequestValidatorInput) String ¶
func (s GetRequestValidatorInput) String() string
String returns the string representation
func (*GetRequestValidatorInput) Validate ¶
func (s *GetRequestValidatorInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetRequestValidatorOutput ¶
type GetRequestValidatorOutput struct { // The identifier of this RequestValidator. Id *string `locationName:"id" type:"string"` // The name of this RequestValidator Name *string `locationName:"name" type:"string"` // A Boolean flag to indicate whether to validate a request body according to // the configured Model schema. ValidateRequestBody *bool `locationName:"validateRequestBody" type:"boolean"` // A Boolean flag to indicate whether to validate request parameters (true) // or not (false). ValidateRequestParameters *bool `locationName:"validateRequestParameters" type:"boolean"` // contains filtered or unexported fields }
A set of validation rules for incoming Method requests.
In OpenAPI, a RequestValidator of an API is defined by the x-amazon-apigateway-request-validators.requestValidator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.requestValidator.html) object. It the referenced using the x-amazon-apigateway-request-validator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validator) property.
Enable Basic Request Validation in API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
func (GetRequestValidatorOutput) MarshalFields ¶
func (s GetRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRequestValidatorOutput) String ¶
func (s GetRequestValidatorOutput) String() string
String returns the string representation
type GetRequestValidatorRequest ¶
type GetRequestValidatorRequest struct { *aws.Request Input *GetRequestValidatorInput Copy func(*GetRequestValidatorInput) GetRequestValidatorRequest }
GetRequestValidatorRequest is the request type for the GetRequestValidator API operation.
func (GetRequestValidatorRequest) Send ¶
func (r GetRequestValidatorRequest) Send(ctx context.Context) (*GetRequestValidatorResponse, error)
Send marshals and sends the GetRequestValidator API request.
type GetRequestValidatorResponse ¶
type GetRequestValidatorResponse struct { *GetRequestValidatorOutput // contains filtered or unexported fields }
GetRequestValidatorResponse is the response type for the GetRequestValidator API operation.
func (*GetRequestValidatorResponse) SDKResponseMetdata ¶
func (r *GetRequestValidatorResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetRequestValidator request.
type GetRequestValidatorsInput ¶
type GetRequestValidatorsInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets the RequestValidators collection of a given RestApi.
func (GetRequestValidatorsInput) MarshalFields ¶
func (s GetRequestValidatorsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRequestValidatorsInput) String ¶
func (s GetRequestValidatorsInput) String() string
String returns the string representation
func (*GetRequestValidatorsInput) Validate ¶
func (s *GetRequestValidatorsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetRequestValidatorsOutput ¶
type GetRequestValidatorsOutput struct { // The current page of elements from this collection. Items []RequestValidator `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
A collection of RequestValidator resources of a given RestApi.
In OpenAPI, the RequestValidators of an API is defined by the x-amazon-apigateway-request-validators (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.html) extension.
Enable Basic Request Validation in API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
func (GetRequestValidatorsOutput) MarshalFields ¶
func (s GetRequestValidatorsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRequestValidatorsOutput) String ¶
func (s GetRequestValidatorsOutput) String() string
String returns the string representation
type GetRequestValidatorsRequest ¶
type GetRequestValidatorsRequest struct { *aws.Request Input *GetRequestValidatorsInput Copy func(*GetRequestValidatorsInput) GetRequestValidatorsRequest }
GetRequestValidatorsRequest is the request type for the GetRequestValidators API operation.
func (GetRequestValidatorsRequest) Send ¶
func (r GetRequestValidatorsRequest) Send(ctx context.Context) (*GetRequestValidatorsResponse, error)
Send marshals and sends the GetRequestValidators API request.
type GetRequestValidatorsResponse ¶
type GetRequestValidatorsResponse struct { *GetRequestValidatorsOutput // contains filtered or unexported fields }
GetRequestValidatorsResponse is the response type for the GetRequestValidators API operation.
func (*GetRequestValidatorsResponse) SDKResponseMetdata ¶
func (r *GetRequestValidatorsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetRequestValidators request.
type GetResourceInput ¶
type GetResourceInput struct { // A query parameter to retrieve the specified resources embedded in the returned // Resource representation in the response. This embed parameter value is a // list of comma-separated strings. Currently, the request supports only retrieval // of the embedded Method resources this way. The query parameter value must // be a single-valued list and contain the "methods" string. For example, GET // /restapis/{restapi_id}/resources/{resource_id}?embed=methods. Embed []string `location:"querystring" locationName:"embed" type:"list"` // [Required] The identifier for the Resource resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to list information about a resource.
func (GetResourceInput) MarshalFields ¶
func (s GetResourceInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetResourceInput) String ¶
func (s GetResourceInput) String() string
String returns the string representation
func (*GetResourceInput) Validate ¶
func (s *GetResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetResourceOutput ¶
type GetResourceOutput struct { // The resource's identifier. Id *string `locationName:"id" type:"string"` // The parent resource's identifier. ParentId *string `locationName:"parentId" type:"string"` // The full path for this resource. Path *string `locationName:"path" type:"string"` // The last path segment for this resource. PathPart *string `locationName:"pathPart" type:"string"` // Gets an API resource's method of a given HTTP verb. // // The resource methods are a map of methods indexed by methods' HTTP verbs // enabled on the resource. This method map is included in the 200 OK response // of the GET /restapis/{restapi_id}/resources/{resource_id} or GET /restapis/{restapi_id}/resources/{resource_id}?embed=methods // request. // // Example: Get the GET method of an API resource // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: // application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20170223T031827Z // Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20170223/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", // "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", // "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", // "templated": true } }, "apiKeyRequired": false, "authorizationType": "NONE", // "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { // "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": // "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": // "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": // { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.Content-Type": false }, "statusCode": "200" } // } } // If the OPTIONS is enabled on the resource, you can follow the example here // to get that method. Just replace the GET of the last path segment in the // request URL with OPTIONS. ResourceMethods map[string]Method `locationName:"resourceMethods" type:"map"` // contains filtered or unexported fields }
Represents an API resource.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (GetResourceOutput) MarshalFields ¶
func (s GetResourceOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetResourceOutput) String ¶
func (s GetResourceOutput) String() string
String returns the string representation
type GetResourceRequest ¶
type GetResourceRequest struct { *aws.Request Input *GetResourceInput Copy func(*GetResourceInput) GetResourceRequest }
GetResourceRequest is the request type for the GetResource API operation.
func (GetResourceRequest) Send ¶
func (r GetResourceRequest) Send(ctx context.Context) (*GetResourceResponse, error)
Send marshals and sends the GetResource API request.
type GetResourceResponse ¶
type GetResourceResponse struct { *GetResourceOutput // contains filtered or unexported fields }
GetResourceResponse is the response type for the GetResource API operation.
func (*GetResourceResponse) SDKResponseMetdata ¶
func (r *GetResourceResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetResource request.
type GetResourcesInput ¶
type GetResourcesInput struct { // A query parameter used to retrieve the specified resources embedded in the // returned Resources resource in the response. This embed parameter value is // a list of comma-separated strings. Currently, the request supports only retrieval // of the embedded Method resources this way. The query parameter value must // be a single-valued list and contain the "methods" string. For example, GET // /restapis/{restapi_id}/resources?embed=methods. Embed []string `location:"querystring" locationName:"embed" type:"list"` // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to list information about a collection of resources.
func (GetResourcesInput) MarshalFields ¶
func (s GetResourcesInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetResourcesInput) String ¶
func (s GetResourcesInput) String() string
String returns the string representation
func (*GetResourcesInput) Validate ¶
func (s *GetResourcesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetResourcesOutput ¶
type GetResourcesOutput struct { // The current page of elements from this collection. Items []Resource `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection of Resource resources.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (GetResourcesOutput) MarshalFields ¶
func (s GetResourcesOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetResourcesOutput) String ¶
func (s GetResourcesOutput) String() string
String returns the string representation
type GetResourcesPaginator ¶
GetResourcesPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetResourcesPaginator ¶
func NewGetResourcesPaginator(req GetResourcesRequest) GetResourcesPaginator
NewGetResourcesRequestPaginator returns a paginator for GetResources. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetResourcesRequest(input) p := apigateway.NewGetResourcesRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetResourcesPaginator) CurrentPage ¶
func (p *GetResourcesPaginator) CurrentPage() *GetResourcesOutput
type GetResourcesRequest ¶
type GetResourcesRequest struct { *aws.Request Input *GetResourcesInput Copy func(*GetResourcesInput) GetResourcesRequest }
GetResourcesRequest is the request type for the GetResources API operation.
func (GetResourcesRequest) Send ¶
func (r GetResourcesRequest) Send(ctx context.Context) (*GetResourcesResponse, error)
Send marshals and sends the GetResources API request.
type GetResourcesResponse ¶
type GetResourcesResponse struct { *GetResourcesOutput // contains filtered or unexported fields }
GetResourcesResponse is the response type for the GetResources API operation.
func (*GetResourcesResponse) SDKResponseMetdata ¶
func (r *GetResourcesResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetResources request.
type GetRestApiInput ¶
type GetRestApiInput struct { // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
The GET request to list an existing RestApi defined for your collection.
func (GetRestApiInput) MarshalFields ¶
func (s GetRestApiInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRestApiInput) String ¶
func (s GetRestApiInput) String() string
String returns the string representation
func (*GetRestApiInput) Validate ¶
func (s *GetRestApiInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetRestApiOutput ¶
type GetRestApiOutput struct { // 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. ApiKeySource ApiKeySourceType `locationName:"apiKeySource" type:"string" enum:"true"` // The list of binary media types supported by the RestApi. By default, the // RestApi supports only UTF-8-encoded text payloads. BinaryMediaTypes []string `locationName:"binaryMediaTypes" type:"list"` // The timestamp when the API was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The API's description. Description *string `locationName:"description" type:"string"` // The endpoint configuration of this RestApi showing the endpoint types of // the API. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The API's identifier. This identifier is unique across all of your APIs in // API Gateway. Id *string `locationName:"id" type:"string"` // 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. MinimumCompressionSize *int64 `locationName:"minimumCompressionSize" type:"integer"` // The API's name. Name *string `locationName:"name" type:"string"` // A stringified JSON policy document that applies to this RestApi regardless // of the caller and Method configuration. Policy *string `locationName:"policy" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // A version identifier for the API. Version *string `locationName:"version" type:"string"` // The warning messages reported when failonwarnings is turned on during API // import. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
Represents a REST API.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (GetRestApiOutput) MarshalFields ¶
func (s GetRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRestApiOutput) String ¶
func (s GetRestApiOutput) String() string
String returns the string representation
type GetRestApiRequest ¶
type GetRestApiRequest struct { *aws.Request Input *GetRestApiInput Copy func(*GetRestApiInput) GetRestApiRequest }
GetRestApiRequest is the request type for the GetRestApi API operation.
func (GetRestApiRequest) Send ¶
func (r GetRestApiRequest) Send(ctx context.Context) (*GetRestApiResponse, error)
Send marshals and sends the GetRestApi API request.
type GetRestApiResponse ¶
type GetRestApiResponse struct { *GetRestApiOutput // contains filtered or unexported fields }
GetRestApiResponse is the response type for the GetRestApi API operation.
func (*GetRestApiResponse) SDKResponseMetdata ¶
func (r *GetRestApiResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetRestApi request.
type GetRestApisInput ¶
type GetRestApisInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
The GET request to list existing RestApis defined for your collection.
func (GetRestApisInput) MarshalFields ¶
func (s GetRestApisInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRestApisInput) String ¶
func (s GetRestApisInput) String() string
String returns the string representation
type GetRestApisOutput ¶
type GetRestApisOutput struct { // The current page of elements from this collection. Items []RestApi `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Contains references to your APIs and links that guide you in how to interact with your collection. A collection offers a paginated view of your APIs.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (GetRestApisOutput) MarshalFields ¶
func (s GetRestApisOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetRestApisOutput) String ¶
func (s GetRestApisOutput) String() string
String returns the string representation
type GetRestApisPaginator ¶
GetRestApisPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetRestApisPaginator ¶
func NewGetRestApisPaginator(req GetRestApisRequest) GetRestApisPaginator
NewGetRestApisRequestPaginator returns a paginator for GetRestApis. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetRestApisRequest(input) p := apigateway.NewGetRestApisRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetRestApisPaginator) CurrentPage ¶
func (p *GetRestApisPaginator) CurrentPage() *GetRestApisOutput
type GetRestApisRequest ¶
type GetRestApisRequest struct { *aws.Request Input *GetRestApisInput Copy func(*GetRestApisInput) GetRestApisRequest }
GetRestApisRequest is the request type for the GetRestApis API operation.
func (GetRestApisRequest) Send ¶
func (r GetRestApisRequest) Send(ctx context.Context) (*GetRestApisResponse, error)
Send marshals and sends the GetRestApis API request.
type GetRestApisResponse ¶
type GetRestApisResponse struct { *GetRestApisOutput // contains filtered or unexported fields }
GetRestApisResponse is the response type for the GetRestApis API operation.
func (*GetRestApisResponse) SDKResponseMetdata ¶
func (r *GetRestApisResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetRestApis request.
type GetSdkInput ¶
type GetSdkInput struct { // A string-to-string key-value map of query parameters sdkType-dependent properties // of the SDK. For sdkType of objectivec or swift, a parameter named classPrefix // is required. For sdkType of android, parameters named groupId, artifactId, // artifactVersion, and invokerPackage are required. For sdkType of java, parameters // named serviceName and javaPackageName are required. Parameters map[string]string `location:"querystring" locationName:"parameters" type:"map"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The language for the generated SDK. Currently java, javascript, // android, objectivec (for iOS), swift (for iOS), and ruby are supported. // // SdkType is a required field SdkType *string `location:"uri" locationName:"sdk_type" type:"string" required:"true"` // [Required] The name of the Stage that the SDK will use. // // StageName is a required field StageName *string `location:"uri" locationName:"stage_name" type:"string" required:"true"` // contains filtered or unexported fields }
Request a new generated client SDK for a RestApi and Stage.
func (GetSdkInput) MarshalFields ¶
func (s GetSdkInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetSdkInput) String ¶
func (s GetSdkInput) String() string
String returns the string representation
func (*GetSdkInput) Validate ¶
func (s *GetSdkInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetSdkOutput ¶
type GetSdkOutput struct { // The binary blob response to GetSdk, which contains the generated SDK. Body []byte `locationName:"body" type:"blob"` // The content-disposition header value in the HTTP response. ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"string"` // The content-type header value in the HTTP response. ContentType *string `location:"header" locationName:"Content-Type" type:"string"` // contains filtered or unexported fields }
The binary blob response to GetSdk, which contains the generated SDK.
func (GetSdkOutput) MarshalFields ¶
func (s GetSdkOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetSdkOutput) String ¶
func (s GetSdkOutput) String() string
String returns the string representation
type GetSdkRequest ¶
type GetSdkRequest struct { *aws.Request Input *GetSdkInput Copy func(*GetSdkInput) GetSdkRequest }
GetSdkRequest is the request type for the GetSdk API operation.
func (GetSdkRequest) Send ¶
func (r GetSdkRequest) Send(ctx context.Context) (*GetSdkResponse, error)
Send marshals and sends the GetSdk API request.
type GetSdkResponse ¶
type GetSdkResponse struct { *GetSdkOutput // contains filtered or unexported fields }
GetSdkResponse is the response type for the GetSdk API operation.
func (*GetSdkResponse) SDKResponseMetdata ¶
func (r *GetSdkResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetSdk request.
type GetSdkTypeInput ¶
type GetSdkTypeInput struct { // [Required] The identifier of the queried SdkType instance. // // Id is a required field Id *string `location:"uri" locationName:"sdktype_id" type:"string" required:"true"` // contains filtered or unexported fields }
Get an SdkType instance.
func (GetSdkTypeInput) MarshalFields ¶
func (s GetSdkTypeInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetSdkTypeInput) String ¶
func (s GetSdkTypeInput) String() string
String returns the string representation
func (*GetSdkTypeInput) Validate ¶
func (s *GetSdkTypeInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetSdkTypeOutput ¶
type GetSdkTypeOutput struct { // A list of configuration properties of an SdkType. ConfigurationProperties []SdkConfigurationProperty `locationName:"configurationProperties" type:"list"` // The description of an SdkType. Description *string `locationName:"description" type:"string"` // The user-friendly name of an SdkType instance. FriendlyName *string `locationName:"friendlyName" type:"string"` // The identifier of an SdkType instance. Id *string `locationName:"id" type:"string"` // contains filtered or unexported fields }
A type of SDK that API Gateway can generate.
func (GetSdkTypeOutput) MarshalFields ¶
func (s GetSdkTypeOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetSdkTypeOutput) String ¶
func (s GetSdkTypeOutput) String() string
String returns the string representation
type GetSdkTypeRequest ¶
type GetSdkTypeRequest struct { *aws.Request Input *GetSdkTypeInput Copy func(*GetSdkTypeInput) GetSdkTypeRequest }
GetSdkTypeRequest is the request type for the GetSdkType API operation.
func (GetSdkTypeRequest) Send ¶
func (r GetSdkTypeRequest) Send(ctx context.Context) (*GetSdkTypeResponse, error)
Send marshals and sends the GetSdkType API request.
type GetSdkTypeResponse ¶
type GetSdkTypeResponse struct { *GetSdkTypeOutput // contains filtered or unexported fields }
GetSdkTypeResponse is the response type for the GetSdkType API operation.
func (*GetSdkTypeResponse) SDKResponseMetdata ¶
func (r *GetSdkTypeResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetSdkType request.
type GetSdkTypesInput ¶
type GetSdkTypesInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
Get the SdkTypes collection.
func (GetSdkTypesInput) MarshalFields ¶
func (s GetSdkTypesInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetSdkTypesInput) String ¶
func (s GetSdkTypesInput) String() string
String returns the string representation
type GetSdkTypesOutput ¶
type GetSdkTypesOutput struct { // The current page of elements from this collection. Items []SdkType `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
The collection of SdkType instances.
func (GetSdkTypesOutput) MarshalFields ¶
func (s GetSdkTypesOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetSdkTypesOutput) String ¶
func (s GetSdkTypesOutput) String() string
String returns the string representation
type GetSdkTypesRequest ¶
type GetSdkTypesRequest struct { *aws.Request Input *GetSdkTypesInput Copy func(*GetSdkTypesInput) GetSdkTypesRequest }
GetSdkTypesRequest is the request type for the GetSdkTypes API operation.
func (GetSdkTypesRequest) Send ¶
func (r GetSdkTypesRequest) Send(ctx context.Context) (*GetSdkTypesResponse, error)
Send marshals and sends the GetSdkTypes API request.
type GetSdkTypesResponse ¶
type GetSdkTypesResponse struct { *GetSdkTypesOutput // contains filtered or unexported fields }
GetSdkTypesResponse is the response type for the GetSdkTypes API operation.
func (*GetSdkTypesResponse) SDKResponseMetdata ¶
func (r *GetSdkTypesResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetSdkTypes request.
type GetStageInput ¶
type GetStageInput struct { // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The name of the Stage resource to get information about. // // StageName is a required field StageName *string `location:"uri" locationName:"stage_name" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to get information about a Stage resource.
func (GetStageInput) MarshalFields ¶
func (s GetStageInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetStageInput) String ¶
func (s GetStageInput) String() string
String returns the string representation
func (*GetStageInput) Validate ¶
func (s *GetStageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetStageOutput ¶
type GetStageOutput struct { // Settings for logging access in this stage. AccessLogSettings *AccessLogSettings `locationName:"accessLogSettings" type:"structure"` // Specifies whether a cache cluster is enabled for the stage. CacheClusterEnabled *bool `locationName:"cacheClusterEnabled" type:"boolean"` // The size of the cache cluster for the stage, if enabled. CacheClusterSize CacheClusterSize `locationName:"cacheClusterSize" type:"string" enum:"true"` // The status of the cache cluster for the stage, if enabled. CacheClusterStatus CacheClusterStatus `locationName:"cacheClusterStatus" type:"string" enum:"true"` // Settings for the canary deployment in this stage. CanarySettings *CanarySettings `locationName:"canarySettings" type:"structure"` // The identifier of a client certificate for an API stage. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the stage was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The identifier of the Deployment that the stage points to. DeploymentId *string `locationName:"deploymentId" type:"string"` // The stage's description. Description *string `locationName:"description" type:"string"` // The version of the associated API documentation. DocumentationVersion *string `locationName:"documentationVersion" type:"string"` // The timestamp when the stage last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // A map that defines the method settings for a Stage resource. Keys (designated // as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} // for an individual method override, or /\*/\* for overriding all methods in // the stage. MethodSettings map[string]MethodSetting `locationName:"methodSettings" type:"map"` // The name of the stage is the first path segment in the Uniform Resource Identifier // (URI) of a call to API Gateway. Stage names can only contain alphanumeric // characters, hyphens, and underscores. Maximum length is 128 characters. StageName *string `locationName:"stageName" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // Specifies whether active tracing with X-ray is enabled for the Stage. TracingEnabled *bool `locationName:"tracingEnabled" type:"boolean"` // A map that defines the stage variables for a Stage resource. Variable names // can have alphanumeric and underscore characters, and the values must match // [A-Za-z0-9-._~:/?#&=,]+. Variables map[string]string `locationName:"variables" type:"map"` // The ARN of the WebAcl associated with the Stage. WebAclArn *string `locationName:"webAclArn" type:"string"` // contains filtered or unexported fields }
Represents a unique identifier for a version of a deployed RestApi that is callable by users.
Deploy an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-deploy-api.html)
func (GetStageOutput) MarshalFields ¶
func (s GetStageOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetStageOutput) String ¶
func (s GetStageOutput) String() string
String returns the string representation
type GetStageRequest ¶
type GetStageRequest struct { *aws.Request Input *GetStageInput Copy func(*GetStageInput) GetStageRequest }
GetStageRequest is the request type for the GetStage API operation.
func (GetStageRequest) Send ¶
func (r GetStageRequest) Send(ctx context.Context) (*GetStageResponse, error)
Send marshals and sends the GetStage API request.
type GetStageResponse ¶
type GetStageResponse struct { *GetStageOutput // contains filtered or unexported fields }
GetStageResponse is the response type for the GetStage API operation.
func (*GetStageResponse) SDKResponseMetdata ¶
func (r *GetStageResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetStage request.
type GetStagesInput ¶
type GetStagesInput struct { // The stages' deployment identifiers. DeploymentId *string `location:"querystring" locationName:"deploymentId" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to get information about one or more Stage resources.
func (GetStagesInput) MarshalFields ¶
func (s GetStagesInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetStagesInput) String ¶
func (s GetStagesInput) String() string
String returns the string representation
func (*GetStagesInput) Validate ¶
func (s *GetStagesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetStagesOutput ¶
type GetStagesOutput struct { // The current page of elements from this collection. Item []Stage `locationName:"item" type:"list"` // contains filtered or unexported fields }
A list of Stage resources that are associated with the ApiKey resource.
Deploying API in Stages (https://docs.aws.amazon.com/apigateway/latest/developerguide/stages.html)
func (GetStagesOutput) MarshalFields ¶
func (s GetStagesOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetStagesOutput) String ¶
func (s GetStagesOutput) String() string
String returns the string representation
type GetStagesRequest ¶
type GetStagesRequest struct { *aws.Request Input *GetStagesInput Copy func(*GetStagesInput) GetStagesRequest }
GetStagesRequest is the request type for the GetStages API operation.
func (GetStagesRequest) Send ¶
func (r GetStagesRequest) Send(ctx context.Context) (*GetStagesResponse, error)
Send marshals and sends the GetStages API request.
type GetStagesResponse ¶
type GetStagesResponse struct { *GetStagesOutput // contains filtered or unexported fields }
GetStagesResponse is the response type for the GetStages API operation.
func (*GetStagesResponse) SDKResponseMetdata ¶
func (r *GetStagesResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetStages request.
type GetTagsInput ¶
type GetTagsInput struct { // (Not currently supported) The maximum number of returned results per page. // The default value is 25 and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // (Not currently supported) The current pagination position in the paged result // set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The ARN of a resource that can be tagged. The resource ARN must // be URL-encoded. // // ResourceArn is a required field ResourceArn *string `location:"uri" locationName:"resource_arn" type:"string" required:"true"` // contains filtered or unexported fields }
Gets the Tags collection for a given resource.
func (GetTagsInput) MarshalFields ¶
func (s GetTagsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetTagsInput) String ¶
func (s GetTagsInput) String() string
String returns the string representation
func (*GetTagsInput) Validate ¶
func (s *GetTagsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetTagsOutput ¶
type GetTagsOutput struct { // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
The collection of tags. Each tag element is associated with a given resource.
func (GetTagsOutput) MarshalFields ¶
func (s GetTagsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetTagsOutput) String ¶
func (s GetTagsOutput) String() string
String returns the string representation
type GetTagsRequest ¶
type GetTagsRequest struct { *aws.Request Input *GetTagsInput Copy func(*GetTagsInput) GetTagsRequest }
GetTagsRequest is the request type for the GetTags API operation.
func (GetTagsRequest) Send ¶
func (r GetTagsRequest) Send(ctx context.Context) (*GetTagsResponse, error)
Send marshals and sends the GetTags API request.
type GetTagsResponse ¶
type GetTagsResponse struct { *GetTagsOutput // contains filtered or unexported fields }
GetTagsResponse is the response type for the GetTags API operation.
func (*GetTagsResponse) SDKResponseMetdata ¶
func (r *GetTagsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetTags request.
type GetUsageInput ¶
type GetUsageInput struct { // [Required] The ending date (e.g., 2016-12-31) of the usage data. // // EndDate is a required field EndDate *string `location:"querystring" locationName:"endDate" type:"string" required:"true"` // The Id of the API key associated with the resultant usage data. KeyId *string `location:"querystring" locationName:"keyId" type:"string"` // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The starting date (e.g., 2016-01-01) of the usage data. // // StartDate is a required field StartDate *string `location:"querystring" locationName:"startDate" type:"string" required:"true"` // [Required] The Id of the usage plan associated with the usage data. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The GET request to get the usage data of a usage plan in a specified time interval.
func (GetUsageInput) MarshalFields ¶
func (s GetUsageInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsageInput) String ¶
func (s GetUsageInput) String() string
String returns the string representation
func (*GetUsageInput) Validate ¶
func (s *GetUsageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetUsageOutput ¶
type GetUsageOutput struct { // The ending date of the usage data. EndDate *string `locationName:"endDate" type:"string"` // The usage data, as daily logs of used and remaining quotas, over the specified // time interval indexed over the API keys in a usage plan. For example, {..., // "values" : { "{api_key}" : [ [0, 100], [10, 90], [100, 10]]}, where {api_key} // stands for an API key value and the daily log entry is of the format [used // quota, remaining quota]. Items map[string][][]int64 `locationName:"values" type:"map"` Position *string `locationName:"position" type:"string"` // The starting date of the usage data. StartDate *string `locationName:"startDate" type:"string"` // The plan Id associated with this usage data. UsagePlanId *string `locationName:"usagePlanId" type:"string"` // contains filtered or unexported fields }
Represents the usage data of a usage plan.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html), Manage Usage in a Usage Plan (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-usage-plans-with-console.html#api-gateway-usage-plan-manage-usage)
func (GetUsageOutput) MarshalFields ¶
func (s GetUsageOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsageOutput) String ¶
func (s GetUsageOutput) String() string
String returns the string representation
type GetUsagePaginator ¶
GetUsagePaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetUsagePaginator ¶
func NewGetUsagePaginator(req GetUsageRequest) GetUsagePaginator
NewGetUsageRequestPaginator returns a paginator for GetUsage. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetUsageRequest(input) p := apigateway.NewGetUsageRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetUsagePaginator) CurrentPage ¶
func (p *GetUsagePaginator) CurrentPage() *GetUsageOutput
type GetUsagePlanInput ¶
type GetUsagePlanInput struct { // [Required] The identifier of the UsagePlan resource to be retrieved. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The GET request to get a usage plan of a given plan identifier.
func (GetUsagePlanInput) MarshalFields ¶
func (s GetUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlanInput) String ¶
func (s GetUsagePlanInput) String() string
String returns the string representation
func (*GetUsagePlanInput) Validate ¶
func (s *GetUsagePlanInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetUsagePlanKeyInput ¶
type GetUsagePlanKeyInput struct { // [Required] The key Id of the to-be-retrieved UsagePlanKey resource representing // a plan customer. // // KeyId is a required field KeyId *string `location:"uri" locationName:"keyId" type:"string" required:"true"` // [Required] The Id of the UsagePlan resource representing the usage plan containing // the to-be-retrieved UsagePlanKey resource representing a plan customer. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The GET request to get a usage plan key of a given key identifier.
func (GetUsagePlanKeyInput) MarshalFields ¶
func (s GetUsagePlanKeyInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlanKeyInput) String ¶
func (s GetUsagePlanKeyInput) String() string
String returns the string representation
func (*GetUsagePlanKeyInput) Validate ¶
func (s *GetUsagePlanKeyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetUsagePlanKeyOutput ¶
type GetUsagePlanKeyOutput struct { // The Id of a usage plan key. Id *string `locationName:"id" type:"string"` // The name of a usage plan key. Name *string `locationName:"name" type:"string"` // The type of a usage plan key. Currently, the valid key type is API_KEY. Type *string `locationName:"type" type:"string"` // The value of a usage plan key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
Represents a usage plan key to identify a plan customer.
To associate an API stage with a selected API key in a usage plan, you must create a UsagePlanKey resource to represent the selected ApiKey.
" Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (GetUsagePlanKeyOutput) MarshalFields ¶
func (s GetUsagePlanKeyOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlanKeyOutput) String ¶
func (s GetUsagePlanKeyOutput) String() string
String returns the string representation
type GetUsagePlanKeyRequest ¶
type GetUsagePlanKeyRequest struct { *aws.Request Input *GetUsagePlanKeyInput Copy func(*GetUsagePlanKeyInput) GetUsagePlanKeyRequest }
GetUsagePlanKeyRequest is the request type for the GetUsagePlanKey API operation.
func (GetUsagePlanKeyRequest) Send ¶
func (r GetUsagePlanKeyRequest) Send(ctx context.Context) (*GetUsagePlanKeyResponse, error)
Send marshals and sends the GetUsagePlanKey API request.
type GetUsagePlanKeyResponse ¶
type GetUsagePlanKeyResponse struct { *GetUsagePlanKeyOutput // contains filtered or unexported fields }
GetUsagePlanKeyResponse is the response type for the GetUsagePlanKey API operation.
func (*GetUsagePlanKeyResponse) SDKResponseMetdata ¶
func (r *GetUsagePlanKeyResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetUsagePlanKey request.
type GetUsagePlanKeysInput ¶
type GetUsagePlanKeysInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // A query parameter specifying the name of the to-be-returned usage plan keys. NameQuery *string `location:"querystring" locationName:"name" type:"string"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // [Required] The Id of the UsagePlan resource representing the usage plan containing // the to-be-retrieved UsagePlanKey resource representing a plan customer. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The GET request to get all the usage plan keys representing the API keys added to a specified usage plan.
func (GetUsagePlanKeysInput) MarshalFields ¶
func (s GetUsagePlanKeysInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlanKeysInput) String ¶
func (s GetUsagePlanKeysInput) String() string
String returns the string representation
func (*GetUsagePlanKeysInput) Validate ¶
func (s *GetUsagePlanKeysInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetUsagePlanKeysOutput ¶
type GetUsagePlanKeysOutput struct { // The current page of elements from this collection. Items []UsagePlanKey `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents the collection of usage plan keys added to usage plans for the associated API keys and, possibly, other types of keys.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (GetUsagePlanKeysOutput) MarshalFields ¶
func (s GetUsagePlanKeysOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlanKeysOutput) String ¶
func (s GetUsagePlanKeysOutput) String() string
String returns the string representation
type GetUsagePlanKeysPaginator ¶
GetUsagePlanKeysPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetUsagePlanKeysPaginator ¶
func NewGetUsagePlanKeysPaginator(req GetUsagePlanKeysRequest) GetUsagePlanKeysPaginator
NewGetUsagePlanKeysRequestPaginator returns a paginator for GetUsagePlanKeys. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetUsagePlanKeysRequest(input) p := apigateway.NewGetUsagePlanKeysRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetUsagePlanKeysPaginator) CurrentPage ¶
func (p *GetUsagePlanKeysPaginator) CurrentPage() *GetUsagePlanKeysOutput
type GetUsagePlanKeysRequest ¶
type GetUsagePlanKeysRequest struct { *aws.Request Input *GetUsagePlanKeysInput Copy func(*GetUsagePlanKeysInput) GetUsagePlanKeysRequest }
GetUsagePlanKeysRequest is the request type for the GetUsagePlanKeys API operation.
func (GetUsagePlanKeysRequest) Send ¶
func (r GetUsagePlanKeysRequest) Send(ctx context.Context) (*GetUsagePlanKeysResponse, error)
Send marshals and sends the GetUsagePlanKeys API request.
type GetUsagePlanKeysResponse ¶
type GetUsagePlanKeysResponse struct { *GetUsagePlanKeysOutput // contains filtered or unexported fields }
GetUsagePlanKeysResponse is the response type for the GetUsagePlanKeys API operation.
func (*GetUsagePlanKeysResponse) SDKResponseMetdata ¶
func (r *GetUsagePlanKeysResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetUsagePlanKeys request.
type GetUsagePlanOutput ¶
type GetUsagePlanOutput struct { // The associated API stages of a usage plan. ApiStages []ApiStage `locationName:"apiStages" type:"list"` // The description of a usage plan. Description *string `locationName:"description" type:"string"` // The identifier of a UsagePlan resource. Id *string `locationName:"id" type:"string"` // The name of a usage plan. Name *string `locationName:"name" type:"string"` // The AWS Markeplace product identifier to associate with the usage plan as // a SaaS product on AWS Marketplace. ProductCode *string `locationName:"productCode" type:"string"` // The maximum number of permitted requests per a given unit time interval. Quota *QuotaSettings `locationName:"quota" type:"structure"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The request throttle limits of a usage plan. Throttle *ThrottleSettings `locationName:"throttle" type:"structure"` // contains filtered or unexported fields }
Represents a usage plan than can specify who can assess associated API stages with specified request limits and quotas.
In a usage plan, you associate an API by specifying the API's Id and a stage name of the specified API. You add plan customers by adding API keys to the plan.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (GetUsagePlanOutput) MarshalFields ¶
func (s GetUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlanOutput) String ¶
func (s GetUsagePlanOutput) String() string
String returns the string representation
type GetUsagePlanRequest ¶
type GetUsagePlanRequest struct { *aws.Request Input *GetUsagePlanInput Copy func(*GetUsagePlanInput) GetUsagePlanRequest }
GetUsagePlanRequest is the request type for the GetUsagePlan API operation.
func (GetUsagePlanRequest) Send ¶
func (r GetUsagePlanRequest) Send(ctx context.Context) (*GetUsagePlanResponse, error)
Send marshals and sends the GetUsagePlan API request.
type GetUsagePlanResponse ¶
type GetUsagePlanResponse struct { *GetUsagePlanOutput // contains filtered or unexported fields }
GetUsagePlanResponse is the response type for the GetUsagePlan API operation.
func (*GetUsagePlanResponse) SDKResponseMetdata ¶
func (r *GetUsagePlanResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetUsagePlan request.
type GetUsagePlansInput ¶
type GetUsagePlansInput struct { // The identifier of the API key associated with the usage plans. KeyId *string `location:"querystring" locationName:"keyId" type:"string"` // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
The GET request to get all the usage plans of the caller's account.
func (GetUsagePlansInput) MarshalFields ¶
func (s GetUsagePlansInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlansInput) String ¶
func (s GetUsagePlansInput) String() string
String returns the string representation
type GetUsagePlansOutput ¶
type GetUsagePlansOutput struct { // The current page of elements from this collection. Items []UsagePlan `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
Represents a collection of usage plans for an AWS account.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (GetUsagePlansOutput) MarshalFields ¶
func (s GetUsagePlansOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetUsagePlansOutput) String ¶
func (s GetUsagePlansOutput) String() string
String returns the string representation
type GetUsagePlansPaginator ¶
GetUsagePlansPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetUsagePlansPaginator ¶
func NewGetUsagePlansPaginator(req GetUsagePlansRequest) GetUsagePlansPaginator
NewGetUsagePlansRequestPaginator returns a paginator for GetUsagePlans. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetUsagePlansRequest(input) p := apigateway.NewGetUsagePlansRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetUsagePlansPaginator) CurrentPage ¶
func (p *GetUsagePlansPaginator) CurrentPage() *GetUsagePlansOutput
type GetUsagePlansRequest ¶
type GetUsagePlansRequest struct { *aws.Request Input *GetUsagePlansInput Copy func(*GetUsagePlansInput) GetUsagePlansRequest }
GetUsagePlansRequest is the request type for the GetUsagePlans API operation.
func (GetUsagePlansRequest) Send ¶
func (r GetUsagePlansRequest) Send(ctx context.Context) (*GetUsagePlansResponse, error)
Send marshals and sends the GetUsagePlans API request.
type GetUsagePlansResponse ¶
type GetUsagePlansResponse struct { *GetUsagePlansOutput // contains filtered or unexported fields }
GetUsagePlansResponse is the response type for the GetUsagePlans API operation.
func (*GetUsagePlansResponse) SDKResponseMetdata ¶
func (r *GetUsagePlansResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetUsagePlans request.
type GetUsageRequest ¶
type GetUsageRequest struct { *aws.Request Input *GetUsageInput Copy func(*GetUsageInput) GetUsageRequest }
GetUsageRequest is the request type for the GetUsage API operation.
func (GetUsageRequest) Send ¶
func (r GetUsageRequest) Send(ctx context.Context) (*GetUsageResponse, error)
Send marshals and sends the GetUsage API request.
type GetUsageResponse ¶
type GetUsageResponse struct { *GetUsageOutput // contains filtered or unexported fields }
GetUsageResponse is the response type for the GetUsage API operation.
func (*GetUsageResponse) SDKResponseMetdata ¶
func (r *GetUsageResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetUsage request.
type GetVpcLinkInput ¶
type GetVpcLinkInput struct { // [Required] The identifier of the VpcLink. It is used in an Integration to // reference this VpcLink. // // VpcLinkId is a required field VpcLinkId *string `location:"uri" locationName:"vpclink_id" type:"string" required:"true"` // contains filtered or unexported fields }
Gets a specified VPC link under the caller's account in a region.
func (GetVpcLinkInput) MarshalFields ¶
func (s GetVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetVpcLinkInput) String ¶
func (s GetVpcLinkInput) String() string
String returns the string representation
func (*GetVpcLinkInput) Validate ¶
func (s *GetVpcLinkInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetVpcLinkOutput ¶
type GetVpcLinkOutput struct { // The description of the VPC link. Description *string `locationName:"description" type:"string"` // The identifier of the VpcLink. It is used in an Integration to reference // this VpcLink. Id *string `locationName:"id" type:"string"` // The name used to label and identify the VPC link. Name *string `locationName:"name" type:"string"` // The status of the VPC link. The valid values are AVAILABLE, PENDING, DELETING, // or FAILED. Deploying an API will wait if the status is PENDING and will fail // if the status is DELETING. Status VpcLinkStatus `locationName:"status" type:"string" enum:"true"` // A description about the VPC link status. StatusMessage *string `locationName:"statusMessage" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The ARNs of network load balancers of the VPC targeted by the VPC link. The // network load balancers must be owned by the same AWS account of the API owner. TargetArns []string `locationName:"targetArns" type:"list"` // contains filtered or unexported fields }
A API Gateway VPC link for a RestApi to access resources in an Amazon Virtual Private Cloud (VPC).
To enable access to a resource in an Amazon Virtual Private Cloud through Amazon API Gateway, you, as an API developer, create a VpcLink resource targeted for one or more network load balancers of the VPC and then integrate an API method with a private integration that uses the VpcLink. The private integration has an integration type of HTTP or HTTP_PROXY and has a connection type of VPC_LINK. The integration uses the connectionId property to identify the VpcLink used.
func (GetVpcLinkOutput) MarshalFields ¶
func (s GetVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetVpcLinkOutput) String ¶
func (s GetVpcLinkOutput) String() string
String returns the string representation
type GetVpcLinkRequest ¶
type GetVpcLinkRequest struct { *aws.Request Input *GetVpcLinkInput Copy func(*GetVpcLinkInput) GetVpcLinkRequest }
GetVpcLinkRequest is the request type for the GetVpcLink API operation.
func (GetVpcLinkRequest) Send ¶
func (r GetVpcLinkRequest) Send(ctx context.Context) (*GetVpcLinkResponse, error)
Send marshals and sends the GetVpcLink API request.
type GetVpcLinkResponse ¶
type GetVpcLinkResponse struct { *GetVpcLinkOutput // contains filtered or unexported fields }
GetVpcLinkResponse is the response type for the GetVpcLink API operation.
func (*GetVpcLinkResponse) SDKResponseMetdata ¶
func (r *GetVpcLinkResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetVpcLink request.
type GetVpcLinksInput ¶
type GetVpcLinksInput struct { // The maximum number of returned results per page. The default value is 25 // and the maximum value is 500. Limit *int64 `location:"querystring" locationName:"limit" type:"integer"` // The current pagination position in the paged result set. Position *string `location:"querystring" locationName:"position" type:"string"` // contains filtered or unexported fields }
Gets the VpcLinks collection under the caller's account in a selected region.
func (GetVpcLinksInput) MarshalFields ¶
func (s GetVpcLinksInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetVpcLinksInput) String ¶
func (s GetVpcLinksInput) String() string
String returns the string representation
type GetVpcLinksOutput ¶
type GetVpcLinksOutput struct { // The current page of elements from this collection. Items []VpcLink `locationName:"item" type:"list"` Position *string `locationName:"position" type:"string"` // contains filtered or unexported fields }
The collection of VPC links under the caller's account in a region.
Getting Started with Private Integrations (https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-with-private-integration.html), Set up Private Integrations (https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-private-integration.html)
func (GetVpcLinksOutput) MarshalFields ¶
func (s GetVpcLinksOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (GetVpcLinksOutput) String ¶
func (s GetVpcLinksOutput) String() string
String returns the string representation
type GetVpcLinksPaginator ¶
GetVpcLinksPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.
func NewGetVpcLinksPaginator ¶
func NewGetVpcLinksPaginator(req GetVpcLinksRequest) GetVpcLinksPaginator
NewGetVpcLinksRequestPaginator returns a paginator for GetVpcLinks. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.
Note: This operation can generate multiple requests to a service.
// Example iterating over pages. req := client.GetVpcLinksRequest(input) p := apigateway.NewGetVpcLinksRequestPaginator(req) for p.Next(context.TODO()) { page := p.CurrentPage() } if err := p.Err(); err != nil { return err }
func (*GetVpcLinksPaginator) CurrentPage ¶
func (p *GetVpcLinksPaginator) CurrentPage() *GetVpcLinksOutput
type GetVpcLinksRequest ¶
type GetVpcLinksRequest struct { *aws.Request Input *GetVpcLinksInput Copy func(*GetVpcLinksInput) GetVpcLinksRequest }
GetVpcLinksRequest is the request type for the GetVpcLinks API operation.
func (GetVpcLinksRequest) Send ¶
func (r GetVpcLinksRequest) Send(ctx context.Context) (*GetVpcLinksResponse, error)
Send marshals and sends the GetVpcLinks API request.
type GetVpcLinksResponse ¶
type GetVpcLinksResponse struct { *GetVpcLinksOutput // contains filtered or unexported fields }
GetVpcLinksResponse is the response type for the GetVpcLinks API operation.
func (*GetVpcLinksResponse) SDKResponseMetdata ¶
func (r *GetVpcLinksResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the GetVpcLinks request.
type ImportApiKeysInput ¶
type ImportApiKeysInput struct { // The payload of the POST request to import API keys. For the payload format, // see API Key File Format (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-key-file-format.html). // // Body is a required field Body []byte `locationName:"body" type:"blob" required:"true"` // A query parameter to indicate whether to rollback ApiKey importation (true) // or not (false) when error is encountered. FailOnWarnings *bool `location:"querystring" locationName:"failonwarnings" type:"boolean"` // A query parameter to specify the input format to imported API keys. Currently, // only the csv format is supported. // // Format is a required field Format ApiKeysFormat `location:"querystring" locationName:"format" type:"string" required:"true" enum:"true"` // contains filtered or unexported fields }
The POST request to import API keys from an external source, such as a CSV-formatted file.
func (ImportApiKeysInput) MarshalFields ¶
func (s ImportApiKeysInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ImportApiKeysInput) String ¶
func (s ImportApiKeysInput) String() string
String returns the string representation
func (*ImportApiKeysInput) Validate ¶
func (s *ImportApiKeysInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ImportApiKeysOutput ¶
type ImportApiKeysOutput struct { // A list of all the ApiKey identifiers. Ids []string `locationName:"ids" type:"list"` // A list of warning messages. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
The identifier of an ApiKey used in a UsagePlan.
func (ImportApiKeysOutput) MarshalFields ¶
func (s ImportApiKeysOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ImportApiKeysOutput) String ¶
func (s ImportApiKeysOutput) String() string
String returns the string representation
type ImportApiKeysRequest ¶
type ImportApiKeysRequest struct { *aws.Request Input *ImportApiKeysInput Copy func(*ImportApiKeysInput) ImportApiKeysRequest }
ImportApiKeysRequest is the request type for the ImportApiKeys API operation.
func (ImportApiKeysRequest) Send ¶
func (r ImportApiKeysRequest) Send(ctx context.Context) (*ImportApiKeysResponse, error)
Send marshals and sends the ImportApiKeys API request.
type ImportApiKeysResponse ¶
type ImportApiKeysResponse struct { *ImportApiKeysOutput // contains filtered or unexported fields }
ImportApiKeysResponse is the response type for the ImportApiKeys API operation.
func (*ImportApiKeysResponse) SDKResponseMetdata ¶
func (r *ImportApiKeysResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the ImportApiKeys request.
type ImportDocumentationPartsInput ¶
type ImportDocumentationPartsInput struct { // [Required] Raw byte array representing the to-be-imported documentation parts. // To import from an OpenAPI file, this is a JSON object. // // Body is a required field Body []byte `locationName:"body" type:"blob" required:"true"` // A query parameter to specify whether to rollback the documentation importation // (true) or not (false) when a warning is encountered. The default value is // false. FailOnWarnings *bool `location:"querystring" locationName:"failonwarnings" type:"boolean"` // A query parameter to indicate whether to overwrite (OVERWRITE) any existing // DocumentationParts definition or to merge (MERGE) the new definition into // the existing one. The default value is MERGE. Mode PutMode `location:"querystring" locationName:"mode" type:"string" enum:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Import documentation parts from an external (e.g., OpenAPI) definition file.
func (ImportDocumentationPartsInput) MarshalFields ¶
func (s ImportDocumentationPartsInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ImportDocumentationPartsInput) String ¶
func (s ImportDocumentationPartsInput) String() string
String returns the string representation
func (*ImportDocumentationPartsInput) Validate ¶
func (s *ImportDocumentationPartsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ImportDocumentationPartsOutput ¶
type ImportDocumentationPartsOutput struct { // A list of the returned documentation part identifiers. Ids []string `locationName:"ids" type:"list"` // A list of warning messages reported during import of documentation parts. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
A collection of the imported DocumentationPart identifiers.
This is used to return the result when documentation parts in an external (e.g., OpenAPI) file are imported into API Gateway
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), documentationpart:import (https://docs.aws.amazon.com/apigateway/api-reference/link-relation/documentationpart-import/), DocumentationPart
func (ImportDocumentationPartsOutput) MarshalFields ¶
func (s ImportDocumentationPartsOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ImportDocumentationPartsOutput) String ¶
func (s ImportDocumentationPartsOutput) String() string
String returns the string representation
type ImportDocumentationPartsRequest ¶
type ImportDocumentationPartsRequest struct { *aws.Request Input *ImportDocumentationPartsInput Copy func(*ImportDocumentationPartsInput) ImportDocumentationPartsRequest }
ImportDocumentationPartsRequest is the request type for the ImportDocumentationParts API operation.
func (ImportDocumentationPartsRequest) Send ¶
func (r ImportDocumentationPartsRequest) Send(ctx context.Context) (*ImportDocumentationPartsResponse, error)
Send marshals and sends the ImportDocumentationParts API request.
type ImportDocumentationPartsResponse ¶
type ImportDocumentationPartsResponse struct { *ImportDocumentationPartsOutput // contains filtered or unexported fields }
ImportDocumentationPartsResponse is the response type for the ImportDocumentationParts API operation.
func (*ImportDocumentationPartsResponse) SDKResponseMetdata ¶
func (r *ImportDocumentationPartsResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the ImportDocumentationParts request.
type ImportRestApiInput ¶
type ImportRestApiInput struct { // [Required] The POST request body containing external API definitions. Currently, // only OpenAPI definition JSON/YAML files are supported. The maximum size of // the API definition file is 2MB. // // Body is a required field Body []byte `locationName:"body" type:"blob" required:"true"` // A query parameter to indicate whether to rollback the API creation (true) // or not (false) when a warning is encountered. The default value is false. FailOnWarnings *bool `location:"querystring" locationName:"failonwarnings" type:"boolean"` // A key-value map of context-specific query string parameters specifying the // behavior of different API importing operations. The following shows operation-specific // parameters and their supported values. // // To exclude DocumentationParts from the import, set parameters as ignore=documentation. // // To configure the endpoint type, set parameters as endpointConfigurationTypes=EDGE, // endpointConfigurationTypes=REGIONAL, or endpointConfigurationTypes=PRIVATE. // The default endpoint type is EDGE. // // To handle imported basepath, set parameters as basepath=ignore, basepath=prepend // or basepath=split. // // For example, the AWS CLI command to exclude documentation from the imported // API is: // // aws apigateway import-rest-api --parameters ignore=documentation --body // 'file:///path/to/imported-api-body.json' // // The AWS CLI command to set the regional endpoint on the imported API is: // // aws apigateway import-rest-api --parameters endpointConfigurationTypes=REGIONAL // --body 'file:///path/to/imported-api-body.json' Parameters map[string]string `location:"querystring" locationName:"parameters" type:"map"` // contains filtered or unexported fields }
A POST request to import an API to API Gateway using an input of an API definition file.
func (ImportRestApiInput) MarshalFields ¶
func (s ImportRestApiInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ImportRestApiInput) String ¶
func (s ImportRestApiInput) String() string
String returns the string representation
func (*ImportRestApiInput) Validate ¶
func (s *ImportRestApiInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ImportRestApiOutput ¶
type ImportRestApiOutput struct { // 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. ApiKeySource ApiKeySourceType `locationName:"apiKeySource" type:"string" enum:"true"` // The list of binary media types supported by the RestApi. By default, the // RestApi supports only UTF-8-encoded text payloads. BinaryMediaTypes []string `locationName:"binaryMediaTypes" type:"list"` // The timestamp when the API was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The API's description. Description *string `locationName:"description" type:"string"` // The endpoint configuration of this RestApi showing the endpoint types of // the API. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The API's identifier. This identifier is unique across all of your APIs in // API Gateway. Id *string `locationName:"id" type:"string"` // 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. MinimumCompressionSize *int64 `locationName:"minimumCompressionSize" type:"integer"` // The API's name. Name *string `locationName:"name" type:"string"` // A stringified JSON policy document that applies to this RestApi regardless // of the caller and Method configuration. Policy *string `locationName:"policy" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // A version identifier for the API. Version *string `locationName:"version" type:"string"` // The warning messages reported when failonwarnings is turned on during API // import. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
Represents a REST API.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (ImportRestApiOutput) MarshalFields ¶
func (s ImportRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ImportRestApiOutput) String ¶
func (s ImportRestApiOutput) String() string
String returns the string representation
type ImportRestApiRequest ¶
type ImportRestApiRequest struct { *aws.Request Input *ImportRestApiInput Copy func(*ImportRestApiInput) ImportRestApiRequest }
ImportRestApiRequest is the request type for the ImportRestApi API operation.
func (ImportRestApiRequest) Send ¶
func (r ImportRestApiRequest) Send(ctx context.Context) (*ImportRestApiResponse, error)
Send marshals and sends the ImportRestApi API request.
type ImportRestApiResponse ¶
type ImportRestApiResponse struct { *ImportRestApiOutput // contains filtered or unexported fields }
ImportRestApiResponse is the response type for the ImportRestApi API operation.
func (*ImportRestApiResponse) SDKResponseMetdata ¶
func (r *ImportRestApiResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the ImportRestApi request.
type Integration ¶
type Integration struct { // A list of request parameters whose values API Gateway caches. To be valid // values for cacheKeyParameters, these parameters must also be specified for // Method requestParameters. CacheKeyParameters []string `locationName:"cacheKeyParameters" type:"list"` // An API-specific tag group of related cached parameters. To be valid values // for cacheKeyParameters, these parameters must also be specified for Method // requestParameters. CacheNamespace *string `locationName:"cacheNamespace" type:"string"` // The (id (https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id)) // of the VpcLink used for the integration when connectionType=VPC_LINK and // undefined, otherwise. ConnectionId *string `locationName:"connectionId" type:"string"` // The type of the network connection to the integration endpoint. The valid // value is INTERNET for connections through the public routable internet or // VPC_LINK for private connections between API Gateway and a network load balancer // in a VPC. The default value is INTERNET. ConnectionType ConnectionType `locationName:"connectionType" type:"string" enum:"true"` // Specifies how to handle request payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a request payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a request payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the request payload will be passed through // from the method request to integration request without modification, provided // that the passthroughBehavior is configured to support payload pass-through. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // Specifies the credentials required for the integration, if any. For AWS integrations, // three options are available. To specify an IAM Role for API Gateway to assume, // use the role's Amazon Resource Name (ARN). To require that the caller's identity // be passed through from the request, specify the string arn:aws:iam::\*:user/\*. // To use resource-based permissions on supported AWS services, specify null. Credentials *string `locationName:"credentials" type:"string"` // Specifies the integration's HTTP method type. HttpMethod *string `locationName:"httpMethod" type:"string"` // Specifies the integration's responses. // // Example: Get integration responses of a method // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200 // HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // X-Amz-Date: 20160607T191449Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160607/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns 200 OK status and a payload as follows: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } // // Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html) IntegrationResponses map[string]IntegrationResponse `locationName:"integrationResponses" type:"map"` // Specifies how the method request body of an unmapped content type will be // passed through the integration request to the back end without transformation. // A content type is unmapped if no mapping template is defined in the integration // or the content type does not match any of the mapped content types, as specified // in requestTemplates. The valid value is one of the following: // // * WHEN_NO_MATCH: passes the method request body through the integration // request to the back end without transformation when the method request // content type does not match any content type associated with the mapping // templates defined in the integration request. // // * WHEN_NO_TEMPLATES: passes the method request body through the integration // request to the back end without transformation when no mapping template // is defined in the integration request. If a template is defined when this // option is selected, the method request of an unmapped content-type will // be rejected with an HTTP 415 Unsupported Media Type response. // // * NEVER: rejects the method request with an HTTP 415 Unsupported Media // Type response when either the method request content type does not match // any content type associated with the mapping templates defined in the // integration request or no mapping template is defined in the integration // request. PassthroughBehavior *string `locationName:"passthroughBehavior" type:"string"` // A key-value map specifying request parameters that are passed from the method // request to the back end. The key is an integration request parameter name // and the associated value is a method request parameter value or static value // that must be enclosed within single quotes and pre-encoded as required by // the back end. The method request parameter value must match the pattern of // method.request.{location}.{name}, where location is querystring, path, or // header and name must be a valid and unique method request parameter name. RequestParameters map[string]string `locationName:"requestParameters" type:"map"` // Represents a map of Velocity templates that are applied on the request payload // based on the value of the Content-Type header sent by the client. The content // type value is the key in this map, and the template (as a String) is the // value. RequestTemplates map[string]string `locationName:"requestTemplates" type:"map"` // Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 // milliseconds or 29 seconds. TimeoutInMillis *int64 `locationName:"timeoutInMillis" type:"integer"` // Specifies an API method integration type. The valid value is one of the following: // // * AWS: for integrating the API method request with an AWS service action, // including the Lambda function-invoking action. With the Lambda function-invoking // action, this is referred to as the Lambda custom integration. With any // other AWS service action, this is known as AWS integration. // // * AWS_PROXY: for integrating the API method request with the Lambda function-invoking // action with the client request passed through as-is. This integration // is also referred to as the Lambda proxy integration. // // * HTTP: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC. This integration is also // referred to as the HTTP custom integration. // // * HTTP_PROXY: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC, with the client request // passed through as-is. This is also referred to as the HTTP proxy integration. // // * MOCK: for integrating the API method request with API Gateway as a "loop-back" // endpoint without invoking any backend. // // For the HTTP and HTTP proxy integrations, each integration can specify a // protocol (http/https), port and path. Standard 80 and 443 ports are supported // as well as custom ports above 1024. An HTTP or HTTP proxy integration with // a connectionType of VPC_LINK is referred to as a private integration and // uses a VpcLink to connect API Gateway to a network load balancer of a VPC. Type IntegrationType `locationName:"type" type:"string" enum:"true"` // Specifies Uniform Resource Identifier (URI) of the integration endpoint. // // * For HTTP or HTTP_PROXY integrations, the URI must be a fully formed, // encoded HTTP(S) URL according to the RFC-3986 specification (https://en.wikipedia.org/wiki/Uniform_Resource_Identifier), // for either standard integration, where connectionType is not VPC_LINK, // or private integration, where connectionType is VPC_LINK. For a private // HTTP integration, the URI is not used for routing. // // * For AWS or AWS_PROXY integrations, the URI is of the form arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api}. // Here, {Region} is the API Gateway region (e.g., us-east-1); {service} // is the name of the integrated AWS service (e.g., s3); and {subdomain} // is a designated subdomain supported by certain AWS service for fast host-name // lookup. action can be used for an AWS service action-based API, using // an Action={name}&{p1}={v1}&p2={v2}... query string. The ensuing {service_api} // refers to a supported action {name} plus any required input parameters. // Alternatively, path can be used for an AWS service path-based API. The // ensuing service_api refers to the path to an AWS service resource, including // the region of the integrated AWS service, if applicable. For example, // for integration with the S3 API of GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html), // the uri can be either arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} // or arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key} Uri *string `locationName:"uri" type:"string"` // contains filtered or unexported fields }
Represents an HTTP, HTTP_PROXY, AWS, AWS_PROXY, or Mock integration.
In the API Gateway console, the built-in Lambda integration is an AWS integration.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (Integration) MarshalFields ¶
func (s Integration) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Integration) String ¶
func (s Integration) String() string
String returns the string representation
type IntegrationResponse ¶
type IntegrationResponse struct { // Specifies how to handle response payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a response payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the response payload will be passed through // from the integration response to the method response without modification. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // A key-value map specifying response parameters that are passed to the method // response from the back end. The key is a method response header parameter // name and the mapped value is an integration response header value, a static // value enclosed within a pair of single quotes, or a JSON expression from // the integration response body. The mapping key must match the pattern of // method.response.header.{name}, where name is a valid and unique header name. // The mapped non-static value must match the pattern of integration.response.header.{name} // or integration.response.body.{JSON-expression}, where name is a valid and // unique response header name and JSON-expression is a valid JSON expression // without the $ prefix. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Specifies the templates used to transform the integration response body. // Response templates are represented as a key/value map, with a content-type // as the key and a template as the value. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // Specifies the regular expression (regex) pattern used to choose an integration // response based on the response from the back end. For example, if the success // response returns nothing and the error response returns some string, you // could use the .+ regex to match error response. However, make sure that the // error response does not contain any newline (\n) character in such cases. // If the back end is an AWS Lambda function, the AWS Lambda function error // header is matched. For all other HTTP and AWS back ends, the HTTP status // code is matched. SelectionPattern *string `locationName:"selectionPattern" type:"string"` // Specifies the status code that is used to map the integration response to // an existing MethodResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents an integration response. The status code must map to an existing MethodResponse, and parameters and templates can be used to transform the back-end response.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (IntegrationResponse) MarshalFields ¶
func (s IntegrationResponse) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (IntegrationResponse) String ¶
func (s IntegrationResponse) String() string
String returns the string representation
type IntegrationType ¶
type IntegrationType string
The integration type. The valid value is HTTP for integrating an API method with an HTTP backend; AWS with any AWS service endpoints; MOCK for testing without actually invoking the backend; HTTP_PROXY for integrating with the HTTP proxy integration; AWS_PROXY for integrating with the Lambda proxy integration.
const ( IntegrationTypeHttp IntegrationType = "HTTP" IntegrationTypeAws IntegrationType = "AWS" IntegrationTypeMock IntegrationType = "MOCK" IntegrationTypeHttpProxy IntegrationType = "HTTP_PROXY" IntegrationTypeAwsProxy IntegrationType = "AWS_PROXY" )
Enum values for IntegrationType
func (IntegrationType) MarshalValue ¶
func (enum IntegrationType) MarshalValue() (string, error)
func (IntegrationType) MarshalValueBuf ¶
func (enum IntegrationType) MarshalValueBuf(b []byte) ([]byte, error)
type LocationStatusType ¶
type LocationStatusType string
const ( LocationStatusTypeDocumented LocationStatusType = "DOCUMENTED" LocationStatusTypeUndocumented LocationStatusType = "UNDOCUMENTED" )
Enum values for LocationStatusType
func (LocationStatusType) MarshalValue ¶
func (enum LocationStatusType) MarshalValue() (string, error)
func (LocationStatusType) MarshalValueBuf ¶
func (enum LocationStatusType) MarshalValueBuf(b []byte) ([]byte, error)
type Method ¶
type Method struct { // A boolean flag specifying whether a valid ApiKey is required to invoke this // method. ApiKeyRequired *bool `locationName:"apiKeyRequired" type:"boolean"` // A list of authorization scopes configured on the method. The scopes are used // with a COGNITO_USER_POOLS authorizer to authorize the method invocation. // The authorization works by matching the method scopes against the scopes // parsed from the access token in the incoming request. The method invocation // is authorized if any method scopes matches a claimed scope in the access // token. Otherwise, the invocation is not authorized. When the method scope // is configured, the client must provide an access token instead of an identity // token for authorization purposes. AuthorizationScopes []string `locationName:"authorizationScopes" type:"list"` // The method's authorization type. Valid values are NONE for open access, AWS_IAM // for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS // for using a Cognito user pool. AuthorizationType *string `locationName:"authorizationType" type:"string"` // The identifier of an Authorizer to use on this method. The authorizationType // must be CUSTOM. AuthorizerId *string `locationName:"authorizerId" type:"string"` // The method's HTTP verb. HttpMethod *string `locationName:"httpMethod" type:"string"` // Gets the method's integration responsible for passing the client-submitted // request to the back end and performing necessary transformations to make // the request compliant with the back end. // // Example: // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T213210Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true } ], "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" }, "integration:delete": // { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "0cjtch", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestTemplates": { "application/json": // "{\n \"a\": \"$input.params('operand1')\",\n \"b\": \"$input.params('operand2')\", // \n \"op\": \"$input.params('operator')\" \n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-west-2:lambda:path//2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:Calc/invocations", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.operator": "integration.response.body.op", // "method.response.header.operand_2": "integration.response.body.b", "method.response.header.operand_1": // "integration.response.body.a" }, "responseTemplates": { "application/json": // "#set($res = $input.path('$'))\n{\n \"result\": \"$res.a, $res.b, $res.op // => $res.c\",\n \"a\" : \"$res.a\",\n \"b\" : \"$res.b\",\n \"op\" : \"$res.op\",\n // \"c\" : \"$res.c\"\n}" }, "selectionPattern": "", "statusCode": "200" } // } } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-integration.html) MethodIntegration *Integration `locationName:"methodIntegration" type:"structure"` // Gets a method response associated with a given HTTP status code. // // The collection of method responses are encapsulated in a key-value map, where // the key is a response's HTTP status code and the value is a MethodResponse // resource that specifies the response returned to the caller from the back // end through the integration response. // // Example: Get a 200 OK response of a GET method // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200 HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T215008Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200", // "title": "200" }, "methodresponse:delete": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.operator": false, "method.response.header.operand_2": // false, "method.response.header.operand_1": false }, "statusCode": "200" // } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-method-response.html) MethodResponses map[string]MethodResponse `locationName:"methodResponses" type:"map"` // A human-friendly operation identifier for the method. For example, you can // assign the operationName of ListPets for the GET /pets method in the PetStore // example. OperationName *string `locationName:"operationName" type:"string"` // A key-value map specifying data schemas, represented by Model resources, // (as the mapped value) of the request payloads of given content types (as // the mapping key). RequestModels map[string]string `locationName:"requestModels" type:"map"` // A key-value map defining required or optional method request parameters that // can be accepted by API Gateway. A key is a method request parameter name // matching the pattern of method.request.{location}.{name}, where location // is querystring, path, or header and name is a valid and unique parameter // name. The value associated with the key is a Boolean flag indicating whether // the parameter is required (true) or optional (false). The method request // parameter names defined here are available in Integration to be mapped to // integration request parameters or templates. RequestParameters map[string]bool `locationName:"requestParameters" type:"map"` // The identifier of a RequestValidator for request validation. RequestValidatorId *string `locationName:"requestValidatorId" type:"string"` // contains filtered or unexported fields }
Represents a client-facing interface by which the client calls the API to access back-end resources. A Method resource is integrated with an Integration resource. Both consist of a request and one or more responses. The method request takes the client input that is passed to the back end through the integration request. A method response returns the output from the back end to the client through an integration response. A method request is embodied in a Method resource, whereas an integration request is embodied in an Integration resource. On the other hand, a method response is represented by a MethodResponse resource, whereas an integration response is represented by an IntegrationResponse resource.
Example: Retrive the GET method on a specified resource
Request
The following example request retrieves the information about the GET method on an API resource (3kzxbg5sa2) of an API (fugvjdxtri).
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T210259Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns a 200 OK status code and a payload similar to the following:
{ "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", "templated": true } }, "apiKeyRequired": true, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": { "integration:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E\")" }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" } } }
In the example above, the response template for the 200 OK response maps the JSON output from the ListStreams action in the back end to an XML output. The mapping template is URL-encoded as %3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E and the output is decoded using the $util.urlDecode() (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#util-templat-reference) helper function.
MethodResponse, Integration, IntegrationResponse, Resource, Set up an API's method (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-method-settings.html)
func (Method) MarshalFields ¶
func (s Method) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Method) String ¶
String returns the string representation
type MethodResponse ¶
type MethodResponse struct { // Specifies the Model resources used for the response's content-type. Response // models are represented as a key/value map, with a content-type as the key // and a Model name as the value. ResponseModels map[string]string `locationName:"responseModels" type:"map"` // A key-value map specifying required or optional response parameters that // API Gateway can send back to the caller. A key defines a method response // header and the value specifies whether the associated method response header // is required or not. The expression of the key must match the pattern method.response.header.{name}, // where name is a valid and unique header name. API Gateway passes certain // integration response data to the method response headers specified here according // to the mapping you prescribe in the API's IntegrationResponse. The integration // response data that can be mapped include an integration response header expressed // in integration.response.header.{name}, a static value enclosed within a pair // of single quotes (e.g., 'application/json'), or a JSON expression from the // back-end response payload in the form of integration.response.body.{JSON-expression}, // where JSON-expression is a valid JSON expression without the $ prefix.) ResponseParameters map[string]bool `locationName:"responseParameters" type:"map"` // The method response's status code. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents a method response of a given HTTP status code returned to the client. The method response is passed from the back end through the associated integration response that can be transformed using a mapping template.
Example: A MethodResponse instance of an API
Request
The example request retrieves a MethodResponse of the 200 status code.
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T222952Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns 200 OK status and a payload as follows:
{ "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" }
Method, IntegrationResponse, Integration Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (MethodResponse) MarshalFields ¶
func (s MethodResponse) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (MethodResponse) String ¶
func (s MethodResponse) String() string
String returns the string representation
type MethodSetting ¶
type MethodSetting struct { // Specifies whether the cached responses are encrypted. The PATCH path for // this setting is /{method_setting_key}/caching/dataEncrypted, and the value // is a Boolean. CacheDataEncrypted *bool `locationName:"cacheDataEncrypted" type:"boolean"` // Specifies the time to live (TTL), in seconds, for cached responses. The higher // the TTL, the longer the response will be cached. The PATCH path for this // setting is /{method_setting_key}/caching/ttlInSeconds, and the value is an // integer. CacheTtlInSeconds *int64 `locationName:"cacheTtlInSeconds" type:"integer"` // Specifies whether responses should be cached and returned for requests. A // cache cluster must be enabled on the stage for responses to be cached. The // PATCH path for this setting is /{method_setting_key}/caching/enabled, and // the value is a Boolean. CachingEnabled *bool `locationName:"cachingEnabled" type:"boolean"` // Specifies whether data trace logging is enabled for this method, which affects // the log entries pushed to Amazon CloudWatch Logs. The PATCH path for this // setting is /{method_setting_key}/logging/dataTrace, and the value is a Boolean. DataTraceEnabled *bool `locationName:"dataTraceEnabled" type:"boolean"` // Specifies the logging level for this method, which affects the log entries // pushed to Amazon CloudWatch Logs. The PATCH path for this setting is /{method_setting_key}/logging/loglevel, // and the available levels are OFF, ERROR, and INFO. LoggingLevel *string `locationName:"loggingLevel" type:"string"` // Specifies whether Amazon CloudWatch metrics are enabled for this method. // The PATCH path for this setting is /{method_setting_key}/metrics/enabled, // and the value is a Boolean. MetricsEnabled *bool `locationName:"metricsEnabled" type:"boolean"` // Specifies whether authorization is required for a cache invalidation request. // The PATCH path for this setting is /{method_setting_key}/caching/requireAuthorizationForCacheControl, // and the value is a Boolean. RequireAuthorizationForCacheControl *bool `locationName:"requireAuthorizationForCacheControl" type:"boolean"` // Specifies the throttling burst limit. The PATCH path for this setting is // /{method_setting_key}/throttling/burstLimit, and the value is an integer. ThrottlingBurstLimit *int64 `locationName:"throttlingBurstLimit" type:"integer"` // Specifies the throttling rate limit. The PATCH path for this setting is /{method_setting_key}/throttling/rateLimit, // and the value is a double. ThrottlingRateLimit *float64 `locationName:"throttlingRateLimit" type:"double"` // Specifies how to handle unauthorized requests for cache invalidation. The // PATCH path for this setting is /{method_setting_key}/caching/unauthorizedCacheControlHeaderStrategy, // and the available values are FAIL_WITH_403, SUCCEED_WITH_RESPONSE_HEADER, // SUCCEED_WITHOUT_RESPONSE_HEADER. UnauthorizedCacheControlHeaderStrategy `locationName:"unauthorizedCacheControlHeaderStrategy" type:"string" enum:"true"` // contains filtered or unexported fields }
Specifies the method setting properties.
func (MethodSetting) MarshalFields ¶
func (s MethodSetting) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (MethodSetting) String ¶
func (s MethodSetting) String() string
String returns the string representation
type MethodSnapshot ¶
type MethodSnapshot struct { // Specifies whether the method requires a valid ApiKey. ApiKeyRequired *bool `locationName:"apiKeyRequired" type:"boolean"` // The method's authorization type. Valid values are NONE for open access, AWS_IAM // for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS // for using a Cognito user pool. AuthorizationType *string `locationName:"authorizationType" type:"string"` // contains filtered or unexported fields }
Represents a summary of a Method resource, given a particular date and time.
func (MethodSnapshot) MarshalFields ¶
func (s MethodSnapshot) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (MethodSnapshot) String ¶
func (s MethodSnapshot) String() string
String returns the string representation
type Model ¶
type Model struct { // The content-type for the model. ContentType *string `locationName:"contentType" type:"string"` // The description of the model. Description *string `locationName:"description" type:"string"` // The identifier for the model resource. Id *string `locationName:"id" type:"string"` // The name of the model. Must be an alphanumeric string. Name *string `locationName:"name" type:"string"` // The schema for the model. For application/json models, this should be JSON // schema draft 4 (https://tools.ietf.org/html/draft-zyp-json-schema-04) model. // Do not include "\*/" characters in the description of any properties because // such "\*/" characters may be interpreted as the closing marker for comments // in some languages, such as Java or JavaScript, causing the installation of // your API's SDK generated by API Gateway to fail. Schema *string `locationName:"schema" type:"string"` // contains filtered or unexported fields }
Represents the data structure of a method's request or response payload.
A request model defines the data structure of the client-supplied request payload. A response model defines the data structure of the response payload returned by the back end. Although not required, models are useful for mapping payloads between the front end and back end.
A model is used for generating an API's SDK, validating the input request body, and creating a skeletal mapping template.
Method, MethodResponse, Models and Mappings (https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html)
func (Model) MarshalFields ¶
func (s Model) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Model) String ¶
String returns the string representation
type Op ¶
type Op string
const ( OpAdd Op = "add" OpRemove Op = "remove" OpReplace Op = "replace" OpMove Op = "move" OpCopy Op = "copy" OpTest Op = "test" )
Enum values for Op
func (Op) MarshalValue ¶
func (Op) MarshalValueBuf ¶
type PatchOperation ¶
type PatchOperation struct { // The copy update operation's source as identified by a JSON-Pointer value // referencing the location within the targeted resource to copy the value from. // For example, to promote a canary deployment, you copy the canary deployment // ID to the affiliated deployment ID by calling a PATCH request on a Stage // resource with "op":"copy", "from":"/canarySettings/deploymentId" and "path":"/deploymentId". From *string `locationName:"from" type:"string"` // An update operation to be performed with this PATCH request. The valid value // can be add, remove, replace or copy. Not all valid operations are supported // for a given resource. Support of the operations depends on specific operational // contexts. Attempts to apply an unsupported operation on a resource will return // an error message. Op Op `locationName:"op" type:"string" enum:"true"` // The op operation's target, as identified by a JSON Pointer (https://tools.ietf.org/html/draft-ietf-appsawg-json-pointer-08) // value that references a location within the targeted resource. For example, // if the target resource has an updateable property of {"name":"value"}, the // path for this property is /name. If the name property value is a JSON object // (e.g., {"name": {"child/name": "child-value"}}), the path for the child/name // property will be /name/child~1name. Any slash ("/") character appearing in // path names must be escaped with "~1", as shown in the example above. Each // op operation can have only one path associated with it. Path *string `locationName:"path" type:"string"` // The new target value of the update operation. It is applicable for the add // or replace operation. When using AWS CLI to update a property of a JSON value, // enclose the JSON object with a pair of single quotes in a Linux shell, e.g., // '{"a": ...}'. In a Windows shell, see Using JSON for Parameters (https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-json). Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
A single patch operation to apply to the specified resource. Please refer to http://tools.ietf.org/html/rfc6902#section-4 for an explanation of how each operation is used.
func (PatchOperation) MarshalFields ¶
func (s PatchOperation) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PatchOperation) String ¶
func (s PatchOperation) String() string
String returns the string representation
type PutGatewayResponseInput ¶
type PutGatewayResponseInput struct { // Response parameters (paths, query strings and headers) of the GatewayResponse // as a string-to-string map of key-value pairs. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Response templates of the GatewayResponse as a string-to-string map of key-value // pairs. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // [Required] // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE // // ResponseType is a required field ResponseType GatewayResponseType `location:"uri" locationName:"response_type" type:"string" required:"true" enum:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // The HTTP status code of the GatewayResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.
func (PutGatewayResponseInput) MarshalFields ¶
func (s PutGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutGatewayResponseInput) String ¶
func (s PutGatewayResponseInput) String() string
String returns the string representation
func (*PutGatewayResponseInput) Validate ¶
func (s *PutGatewayResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutGatewayResponseOutput ¶
type PutGatewayResponseOutput struct { // A Boolean flag to indicate whether this GatewayResponse is the default gateway // response (true) or not (false). A default gateway response is one generated // by API Gateway without any customization by an API developer. DefaultResponse *bool `locationName:"defaultResponse" type:"boolean"` // Response parameters (paths, query strings and headers) of the GatewayResponse // as a string-to-string map of key-value pairs. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Response templates of the GatewayResponse as a string-to-string map of key-value // pairs. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE ResponseType GatewayResponseType `locationName:"responseType" type:"string" enum:"true"` // The HTTP status code for this GatewayResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
A gateway response of a given response type and status code, with optional response parameters and mapping templates.
For more information about valid gateway response types, see Gateway Response Types Supported by API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html)
Example: Get a Gateway Response of a given response type
Request
This example shows how to get a gateway response of the MISSING_AUTHENTICATION_TOKEN type.
GET /restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN HTTP/1.1 Host: beta-apigateway.us-east-1.amazonaws.com Content-Type: application/json X-Amz-Date: 20170503T202516Z Authorization: AWS4-HMAC-SHA256 Credential={access-key-id}/20170503/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=1b52460e3159c1a26cff29093855d50ea141c1c5b937528fecaf60f51129697a Cache-Control: no-cache Postman-Token: 3b2a1ce9-c848-2e26-2e2f-9c2caefbed45
The response type is specified as a URL path.
Response
The successful operation returns the 200 OK status code and a payload similar to the following:
{ "_links": { "curies": { "href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-gatewayresponse-{rel}.html", "name": "gatewayresponse", "templated": true }, "self": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:delete": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" } }, "defaultResponse": false, "responseParameters": { "gatewayresponse.header.x-request-path": "method.request.path.petId", "gatewayresponse.header.Access-Control-Allow-Origin": "'a.b.c'", "gatewayresponse.header.x-request-query": "method.request.querystring.q", "gatewayresponse.header.x-request-header": "method.request.header.Accept" }, "responseTemplates": { "application/json": "{\n \"message\": $context.error.messageString,\n \"type\": \"$context.error.responseType\",\n \"stage\": \"$context.stage\",\n \"resourcePath\": \"$context.resourcePath\",\n \"stageVariables.a\": \"$stageVariables.a\",\n \"statusCode\": \"'404'\"\n}" }, "responseType": "MISSING_AUTHENTICATION_TOKEN", "statusCode": "404" }
Customize Gateway Responses (https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html)
func (PutGatewayResponseOutput) MarshalFields ¶
func (s PutGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutGatewayResponseOutput) String ¶
func (s PutGatewayResponseOutput) String() string
String returns the string representation
type PutGatewayResponseRequest ¶
type PutGatewayResponseRequest struct { *aws.Request Input *PutGatewayResponseInput Copy func(*PutGatewayResponseInput) PutGatewayResponseRequest }
PutGatewayResponseRequest is the request type for the PutGatewayResponse API operation.
func (PutGatewayResponseRequest) Send ¶
func (r PutGatewayResponseRequest) Send(ctx context.Context) (*PutGatewayResponseResponse, error)
Send marshals and sends the PutGatewayResponse API request.
type PutGatewayResponseResponse ¶
type PutGatewayResponseResponse struct { *PutGatewayResponseOutput // contains filtered or unexported fields }
PutGatewayResponseResponse is the response type for the PutGatewayResponse API operation.
func (*PutGatewayResponseResponse) SDKResponseMetdata ¶
func (r *PutGatewayResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the PutGatewayResponse request.
type PutIntegrationInput ¶
type PutIntegrationInput struct { // An API-specific tag group of related cached parameters. CacheKeyParameters []string `locationName:"cacheKeyParameters" type:"list"` // A list of request parameters whose values are to be cached. CacheNamespace *string `locationName:"cacheNamespace" type:"string"` // The (id (https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id)) // of the VpcLink used for the integration when connectionType=VPC_LINK and // undefined, otherwise. ConnectionId *string `locationName:"connectionId" type:"string"` // The type of the network connection to the integration endpoint. The valid // value is INTERNET for connections through the public routable internet or // VPC_LINK for private connections between API Gateway and a network load balancer // in a VPC. The default value is INTERNET. ConnectionType ConnectionType `locationName:"connectionType" type:"string" enum:"true"` // Specifies how to handle request payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a request payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a request payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the request payload will be passed through // from the method request to integration request without modification, provided // that the passthroughBehavior is configured to support payload pass-through. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // Specifies whether credentials are required for a put integration. Credentials *string `locationName:"credentials" type:"string"` // [Required] Specifies a put integration request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // Specifies a put integration HTTP method. When the integration type is HTTP // or AWS, this field is required. IntegrationHttpMethod *string `locationName:"httpMethod" type:"string"` // Specifies the pass-through behavior for incoming requests based on the Content-Type // header in the request, and the available mapping templates specified as the // requestTemplates property on the Integration resource. There are three valid // values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. // // * WHEN_NO_MATCH passes the request body for unmapped content types through // to the integration back end without transformation. // // * NEVER rejects unmapped content types with an HTTP 415 'Unsupported Media // Type' response. // // * WHEN_NO_TEMPLATES allows pass-through when the integration has NO content // types mapped to templates. However if there is at least one content type // defined, unmapped content types will be rejected with the same 415 response. PassthroughBehavior *string `locationName:"passthroughBehavior" type:"string"` // A key-value map specifying request parameters that are passed from the method // request to the back end. The key is an integration request parameter name // and the associated value is a method request parameter value or static value // that must be enclosed within single quotes and pre-encoded as required by // the back end. The method request parameter value must match the pattern of // method.request.{location}.{name}, where location is querystring, path, or // header and name must be a valid and unique method request parameter name. RequestParameters map[string]string `locationName:"requestParameters" type:"map"` // Represents a map of Velocity templates that are applied on the request payload // based on the value of the Content-Type header sent by the client. The content // type value is the key in this map, and the template (as a String) is the // value. RequestTemplates map[string]string `locationName:"requestTemplates" type:"map"` // [Required] Specifies a put integration request's resource ID. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 // milliseconds or 29 seconds. TimeoutInMillis *int64 `locationName:"timeoutInMillis" type:"integer"` // [Required] Specifies a put integration input's type. // // Type is a required field Type IntegrationType `locationName:"type" type:"string" required:"true" enum:"true"` // Specifies Uniform Resource Identifier (URI) of the integration endpoint. // // * For HTTP or HTTP_PROXY integrations, the URI must be a fully formed, // encoded HTTP(S) URL according to the RFC-3986 specification (https://en.wikipedia.org/wiki/Uniform_Resource_Identifier), // for either standard integration, where connectionType is not VPC_LINK, // or private integration, where connectionType is VPC_LINK. For a private // HTTP integration, the URI is not used for routing. // // * For AWS or AWS_PROXY integrations, the URI is of the form arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api}. // Here, {Region} is the API Gateway region (e.g., us-east-1); {service} // is the name of the integrated AWS service (e.g., s3); and {subdomain} // is a designated subdomain supported by certain AWS service for fast host-name // lookup. action can be used for an AWS service action-based API, using // an Action={name}&{p1}={v1}&p2={v2}... query string. The ensuing {service_api} // refers to a supported action {name} plus any required input parameters. // Alternatively, path can be used for an AWS service path-based API. The // ensuing service_api refers to the path to an AWS service resource, including // the region of the integrated AWS service, if applicable. For example, // for integration with the S3 API of GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html), // the uri can be either arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} // or arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key} Uri *string `locationName:"uri" type:"string"` // contains filtered or unexported fields }
Sets up a method's integration.
func (PutIntegrationInput) MarshalFields ¶
func (s PutIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutIntegrationInput) String ¶
func (s PutIntegrationInput) String() string
String returns the string representation
func (*PutIntegrationInput) Validate ¶
func (s *PutIntegrationInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutIntegrationOutput ¶
type PutIntegrationOutput struct { // A list of request parameters whose values API Gateway caches. To be valid // values for cacheKeyParameters, these parameters must also be specified for // Method requestParameters. CacheKeyParameters []string `locationName:"cacheKeyParameters" type:"list"` // An API-specific tag group of related cached parameters. To be valid values // for cacheKeyParameters, these parameters must also be specified for Method // requestParameters. CacheNamespace *string `locationName:"cacheNamespace" type:"string"` // The (id (https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id)) // of the VpcLink used for the integration when connectionType=VPC_LINK and // undefined, otherwise. ConnectionId *string `locationName:"connectionId" type:"string"` // The type of the network connection to the integration endpoint. The valid // value is INTERNET for connections through the public routable internet or // VPC_LINK for private connections between API Gateway and a network load balancer // in a VPC. The default value is INTERNET. ConnectionType ConnectionType `locationName:"connectionType" type:"string" enum:"true"` // Specifies how to handle request payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a request payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a request payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the request payload will be passed through // from the method request to integration request without modification, provided // that the passthroughBehavior is configured to support payload pass-through. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // Specifies the credentials required for the integration, if any. For AWS integrations, // three options are available. To specify an IAM Role for API Gateway to assume, // use the role's Amazon Resource Name (ARN). To require that the caller's identity // be passed through from the request, specify the string arn:aws:iam::\*:user/\*. // To use resource-based permissions on supported AWS services, specify null. Credentials *string `locationName:"credentials" type:"string"` // Specifies the integration's HTTP method type. HttpMethod *string `locationName:"httpMethod" type:"string"` // Specifies the integration's responses. // // Example: Get integration responses of a method // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200 // HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // X-Amz-Date: 20160607T191449Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160607/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns 200 OK status and a payload as follows: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } // // Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html) IntegrationResponses map[string]IntegrationResponse `locationName:"integrationResponses" type:"map"` // Specifies how the method request body of an unmapped content type will be // passed through the integration request to the back end without transformation. // A content type is unmapped if no mapping template is defined in the integration // or the content type does not match any of the mapped content types, as specified // in requestTemplates. The valid value is one of the following: // // * WHEN_NO_MATCH: passes the method request body through the integration // request to the back end without transformation when the method request // content type does not match any content type associated with the mapping // templates defined in the integration request. // // * WHEN_NO_TEMPLATES: passes the method request body through the integration // request to the back end without transformation when no mapping template // is defined in the integration request. If a template is defined when this // option is selected, the method request of an unmapped content-type will // be rejected with an HTTP 415 Unsupported Media Type response. // // * NEVER: rejects the method request with an HTTP 415 Unsupported Media // Type response when either the method request content type does not match // any content type associated with the mapping templates defined in the // integration request or no mapping template is defined in the integration // request. PassthroughBehavior *string `locationName:"passthroughBehavior" type:"string"` // A key-value map specifying request parameters that are passed from the method // request to the back end. The key is an integration request parameter name // and the associated value is a method request parameter value or static value // that must be enclosed within single quotes and pre-encoded as required by // the back end. The method request parameter value must match the pattern of // method.request.{location}.{name}, where location is querystring, path, or // header and name must be a valid and unique method request parameter name. RequestParameters map[string]string `locationName:"requestParameters" type:"map"` // Represents a map of Velocity templates that are applied on the request payload // based on the value of the Content-Type header sent by the client. The content // type value is the key in this map, and the template (as a String) is the // value. RequestTemplates map[string]string `locationName:"requestTemplates" type:"map"` // Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 // milliseconds or 29 seconds. TimeoutInMillis *int64 `locationName:"timeoutInMillis" type:"integer"` // Specifies an API method integration type. The valid value is one of the following: // // * AWS: for integrating the API method request with an AWS service action, // including the Lambda function-invoking action. With the Lambda function-invoking // action, this is referred to as the Lambda custom integration. With any // other AWS service action, this is known as AWS integration. // // * AWS_PROXY: for integrating the API method request with the Lambda function-invoking // action with the client request passed through as-is. This integration // is also referred to as the Lambda proxy integration. // // * HTTP: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC. This integration is also // referred to as the HTTP custom integration. // // * HTTP_PROXY: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC, with the client request // passed through as-is. This is also referred to as the HTTP proxy integration. // // * MOCK: for integrating the API method request with API Gateway as a "loop-back" // endpoint without invoking any backend. // // For the HTTP and HTTP proxy integrations, each integration can specify a // protocol (http/https), port and path. Standard 80 and 443 ports are supported // as well as custom ports above 1024. An HTTP or HTTP proxy integration with // a connectionType of VPC_LINK is referred to as a private integration and // uses a VpcLink to connect API Gateway to a network load balancer of a VPC. Type IntegrationType `locationName:"type" type:"string" enum:"true"` // Specifies Uniform Resource Identifier (URI) of the integration endpoint. // // * For HTTP or HTTP_PROXY integrations, the URI must be a fully formed, // encoded HTTP(S) URL according to the RFC-3986 specification (https://en.wikipedia.org/wiki/Uniform_Resource_Identifier), // for either standard integration, where connectionType is not VPC_LINK, // or private integration, where connectionType is VPC_LINK. For a private // HTTP integration, the URI is not used for routing. // // * For AWS or AWS_PROXY integrations, the URI is of the form arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api}. // Here, {Region} is the API Gateway region (e.g., us-east-1); {service} // is the name of the integrated AWS service (e.g., s3); and {subdomain} // is a designated subdomain supported by certain AWS service for fast host-name // lookup. action can be used for an AWS service action-based API, using // an Action={name}&{p1}={v1}&p2={v2}... query string. The ensuing {service_api} // refers to a supported action {name} plus any required input parameters. // Alternatively, path can be used for an AWS service path-based API. The // ensuing service_api refers to the path to an AWS service resource, including // the region of the integrated AWS service, if applicable. For example, // for integration with the S3 API of GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html), // the uri can be either arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} // or arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key} Uri *string `locationName:"uri" type:"string"` // contains filtered or unexported fields }
Represents an HTTP, HTTP_PROXY, AWS, AWS_PROXY, or Mock integration.
In the API Gateway console, the built-in Lambda integration is an AWS integration.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (PutIntegrationOutput) MarshalFields ¶
func (s PutIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutIntegrationOutput) String ¶
func (s PutIntegrationOutput) String() string
String returns the string representation
type PutIntegrationRequest ¶
type PutIntegrationRequest struct { *aws.Request Input *PutIntegrationInput Copy func(*PutIntegrationInput) PutIntegrationRequest }
PutIntegrationRequest is the request type for the PutIntegration API operation.
func (PutIntegrationRequest) Send ¶
func (r PutIntegrationRequest) Send(ctx context.Context) (*PutIntegrationResponse, error)
Send marshals and sends the PutIntegration API request.
type PutIntegrationResponse ¶
type PutIntegrationResponse struct { *PutIntegrationOutput // contains filtered or unexported fields }
PutIntegrationResponse is the response type for the PutIntegration API operation.
func (*PutIntegrationResponse) SDKResponseMetdata ¶
func (r *PutIntegrationResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the PutIntegration request.
type PutIntegrationResponseInput ¶
type PutIntegrationResponseInput struct { // Specifies how to handle response payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a response payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the response payload will be passed through // from the integration response to the method response without modification. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // [Required] Specifies a put integration response request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] Specifies a put integration response request's resource identifier. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // A key-value map specifying response parameters that are passed to the method // response from the back end. The key is a method response header parameter // name and the mapped value is an integration response header value, a static // value enclosed within a pair of single quotes, or a JSON expression from // the integration response body. The mapping key must match the pattern of // method.response.header.{name}, where name is a valid and unique header name. // The mapped non-static value must match the pattern of integration.response.header.{name} // or integration.response.body.{JSON-expression}, where name must be a valid // and unique response header name and JSON-expression a valid JSON expression // without the $ prefix. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Specifies a put integration response's templates. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // Specifies the selection pattern of a put integration response. SelectionPattern *string `locationName:"selectionPattern" type:"string"` // [Required] Specifies the status code that is used to map the integration // response to an existing MethodResponse. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
Represents a put integration response request.
func (PutIntegrationResponseInput) MarshalFields ¶
func (s PutIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutIntegrationResponseInput) String ¶
func (s PutIntegrationResponseInput) String() string
String returns the string representation
func (*PutIntegrationResponseInput) Validate ¶
func (s *PutIntegrationResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutIntegrationResponseOutput ¶
type PutIntegrationResponseOutput struct { // Specifies how to handle response payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a response payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the response payload will be passed through // from the integration response to the method response without modification. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // A key-value map specifying response parameters that are passed to the method // response from the back end. The key is a method response header parameter // name and the mapped value is an integration response header value, a static // value enclosed within a pair of single quotes, or a JSON expression from // the integration response body. The mapping key must match the pattern of // method.response.header.{name}, where name is a valid and unique header name. // The mapped non-static value must match the pattern of integration.response.header.{name} // or integration.response.body.{JSON-expression}, where name is a valid and // unique response header name and JSON-expression is a valid JSON expression // without the $ prefix. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Specifies the templates used to transform the integration response body. // Response templates are represented as a key/value map, with a content-type // as the key and a template as the value. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // Specifies the regular expression (regex) pattern used to choose an integration // response based on the response from the back end. For example, if the success // response returns nothing and the error response returns some string, you // could use the .+ regex to match error response. However, make sure that the // error response does not contain any newline (\n) character in such cases. // If the back end is an AWS Lambda function, the AWS Lambda function error // header is matched. For all other HTTP and AWS back ends, the HTTP status // code is matched. SelectionPattern *string `locationName:"selectionPattern" type:"string"` // Specifies the status code that is used to map the integration response to // an existing MethodResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents an integration response. The status code must map to an existing MethodResponse, and parameters and templates can be used to transform the back-end response.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (PutIntegrationResponseOutput) MarshalFields ¶
func (s PutIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutIntegrationResponseOutput) String ¶
func (s PutIntegrationResponseOutput) String() string
String returns the string representation
type PutIntegrationResponseRequest ¶
type PutIntegrationResponseRequest struct { *aws.Request Input *PutIntegrationResponseInput Copy func(*PutIntegrationResponseInput) PutIntegrationResponseRequest }
PutIntegrationResponseRequest is the request type for the PutIntegrationResponse API operation.
func (PutIntegrationResponseRequest) Send ¶
func (r PutIntegrationResponseRequest) Send(ctx context.Context) (*PutIntegrationResponseResponse, error)
Send marshals and sends the PutIntegrationResponse API request.
type PutIntegrationResponseResponse ¶
type PutIntegrationResponseResponse struct { *PutIntegrationResponseOutput // contains filtered or unexported fields }
PutIntegrationResponseResponse is the response type for the PutIntegrationResponse API operation.
func (*PutIntegrationResponseResponse) SDKResponseMetdata ¶
func (r *PutIntegrationResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the PutIntegrationResponse request.
type PutMethodInput ¶
type PutMethodInput struct { // Specifies whether the method required a valid ApiKey. ApiKeyRequired *bool `locationName:"apiKeyRequired" type:"boolean"` // A list of authorization scopes configured on the method. The scopes are used // with a COGNITO_USER_POOLS authorizer to authorize the method invocation. // The authorization works by matching the method scopes against the scopes // parsed from the access token in the incoming request. The method invocation // is authorized if any method scopes matches a claimed scope in the access // token. Otherwise, the invocation is not authorized. When the method scope // is configured, the client must provide an access token instead of an identity // token for authorization purposes. AuthorizationScopes []string `locationName:"authorizationScopes" type:"list"` // [Required] The method's authorization type. Valid values are NONE for open // access, AWS_IAM for using AWS IAM permissions, CUSTOM for using a custom // authorizer, or COGNITO_USER_POOLS for using a Cognito user pool. // // AuthorizationType is a required field AuthorizationType *string `locationName:"authorizationType" type:"string" required:"true"` // Specifies the identifier of an Authorizer to use on this Method, if the type // is CUSTOM or COGNITO_USER_POOLS. The authorizer identifier is generated by // API Gateway when you created the authorizer. AuthorizerId *string `locationName:"authorizerId" type:"string"` // [Required] Specifies the method request's HTTP method type. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // A human-friendly operation identifier for the method. For example, you can // assign the operationName of ListPets for the GET /pets method in the PetStore // example. OperationName *string `locationName:"operationName" type:"string"` // Specifies the Model resources used for the request's content type. Request // models are represented as a key/value map, with a content type as the key // and a Model name as the value. RequestModels map[string]string `locationName:"requestModels" type:"map"` // A key-value map defining required or optional method request parameters that // can be accepted by API Gateway. A key defines a method request parameter // name matching the pattern of method.request.{location}.{name}, where location // is querystring, path, or header and name is a valid and unique parameter // name. The value associated with the key is a Boolean flag indicating whether // the parameter is required (true) or optional (false). The method request // parameter names defined here are available in Integration to be mapped to // integration request parameters or body-mapping templates. RequestParameters map[string]bool `locationName:"requestParameters" type:"map"` // The identifier of a RequestValidator for validating the method request. RequestValidatorId *string `locationName:"requestValidatorId" type:"string"` // [Required] The Resource identifier for the new Method resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to add a method to an existing Resource resource.
func (PutMethodInput) MarshalFields ¶
func (s PutMethodInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutMethodInput) String ¶
func (s PutMethodInput) String() string
String returns the string representation
func (*PutMethodInput) Validate ¶
func (s *PutMethodInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutMethodOutput ¶
type PutMethodOutput struct { // A boolean flag specifying whether a valid ApiKey is required to invoke this // method. ApiKeyRequired *bool `locationName:"apiKeyRequired" type:"boolean"` // A list of authorization scopes configured on the method. The scopes are used // with a COGNITO_USER_POOLS authorizer to authorize the method invocation. // The authorization works by matching the method scopes against the scopes // parsed from the access token in the incoming request. The method invocation // is authorized if any method scopes matches a claimed scope in the access // token. Otherwise, the invocation is not authorized. When the method scope // is configured, the client must provide an access token instead of an identity // token for authorization purposes. AuthorizationScopes []string `locationName:"authorizationScopes" type:"list"` // The method's authorization type. Valid values are NONE for open access, AWS_IAM // for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS // for using a Cognito user pool. AuthorizationType *string `locationName:"authorizationType" type:"string"` // The identifier of an Authorizer to use on this method. The authorizationType // must be CUSTOM. AuthorizerId *string `locationName:"authorizerId" type:"string"` // The method's HTTP verb. HttpMethod *string `locationName:"httpMethod" type:"string"` // Gets the method's integration responsible for passing the client-submitted // request to the back end and performing necessary transformations to make // the request compliant with the back end. // // Example: // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T213210Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true } ], "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" }, "integration:delete": // { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "0cjtch", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestTemplates": { "application/json": // "{\n \"a\": \"$input.params('operand1')\",\n \"b\": \"$input.params('operand2')\", // \n \"op\": \"$input.params('operator')\" \n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-west-2:lambda:path//2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:Calc/invocations", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.operator": "integration.response.body.op", // "method.response.header.operand_2": "integration.response.body.b", "method.response.header.operand_1": // "integration.response.body.a" }, "responseTemplates": { "application/json": // "#set($res = $input.path('$'))\n{\n \"result\": \"$res.a, $res.b, $res.op // => $res.c\",\n \"a\" : \"$res.a\",\n \"b\" : \"$res.b\",\n \"op\" : \"$res.op\",\n // \"c\" : \"$res.c\"\n}" }, "selectionPattern": "", "statusCode": "200" } // } } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-integration.html) MethodIntegration *Integration `locationName:"methodIntegration" type:"structure"` // Gets a method response associated with a given HTTP status code. // // The collection of method responses are encapsulated in a key-value map, where // the key is a response's HTTP status code and the value is a MethodResponse // resource that specifies the response returned to the caller from the back // end through the integration response. // // Example: Get a 200 OK response of a GET method // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200 HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T215008Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200", // "title": "200" }, "methodresponse:delete": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.operator": false, "method.response.header.operand_2": // false, "method.response.header.operand_1": false }, "statusCode": "200" // } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-method-response.html) MethodResponses map[string]MethodResponse `locationName:"methodResponses" type:"map"` // A human-friendly operation identifier for the method. For example, you can // assign the operationName of ListPets for the GET /pets method in the PetStore // example. OperationName *string `locationName:"operationName" type:"string"` // A key-value map specifying data schemas, represented by Model resources, // (as the mapped value) of the request payloads of given content types (as // the mapping key). RequestModels map[string]string `locationName:"requestModels" type:"map"` // A key-value map defining required or optional method request parameters that // can be accepted by API Gateway. A key is a method request parameter name // matching the pattern of method.request.{location}.{name}, where location // is querystring, path, or header and name is a valid and unique parameter // name. The value associated with the key is a Boolean flag indicating whether // the parameter is required (true) or optional (false). The method request // parameter names defined here are available in Integration to be mapped to // integration request parameters or templates. RequestParameters map[string]bool `locationName:"requestParameters" type:"map"` // The identifier of a RequestValidator for request validation. RequestValidatorId *string `locationName:"requestValidatorId" type:"string"` // contains filtered or unexported fields }
Represents a client-facing interface by which the client calls the API to access back-end resources. A Method resource is integrated with an Integration resource. Both consist of a request and one or more responses. The method request takes the client input that is passed to the back end through the integration request. A method response returns the output from the back end to the client through an integration response. A method request is embodied in a Method resource, whereas an integration request is embodied in an Integration resource. On the other hand, a method response is represented by a MethodResponse resource, whereas an integration response is represented by an IntegrationResponse resource.
Example: Retrive the GET method on a specified resource
Request
The following example request retrieves the information about the GET method on an API resource (3kzxbg5sa2) of an API (fugvjdxtri).
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T210259Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns a 200 OK status code and a payload similar to the following:
{ "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", "templated": true } }, "apiKeyRequired": true, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": { "integration:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E\")" }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" } } }
In the example above, the response template for the 200 OK response maps the JSON output from the ListStreams action in the back end to an XML output. The mapping template is URL-encoded as %3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E and the output is decoded using the $util.urlDecode() (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#util-templat-reference) helper function.
MethodResponse, Integration, IntegrationResponse, Resource, Set up an API's method (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-method-settings.html)
func (PutMethodOutput) MarshalFields ¶
func (s PutMethodOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutMethodOutput) String ¶
func (s PutMethodOutput) String() string
String returns the string representation
type PutMethodRequest ¶
type PutMethodRequest struct { *aws.Request Input *PutMethodInput Copy func(*PutMethodInput) PutMethodRequest }
PutMethodRequest is the request type for the PutMethod API operation.
func (PutMethodRequest) Send ¶
func (r PutMethodRequest) Send(ctx context.Context) (*PutMethodResponse, error)
Send marshals and sends the PutMethod API request.
type PutMethodResponse ¶
type PutMethodResponse struct { *PutMethodOutput // contains filtered or unexported fields }
PutMethodResponse is the response type for the PutMethod API operation.
func (*PutMethodResponse) SDKResponseMetdata ¶
func (r *PutMethodResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the PutMethod request.
type PutMethodResponseInput ¶
type PutMethodResponseInput struct { // [Required] The HTTP verb of the Method resource. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // [Required] The Resource identifier for the Method resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // Specifies the Model resources used for the response's content type. Response // models are represented as a key/value map, with a content type as the key // and a Model name as the value. ResponseModels map[string]string `locationName:"responseModels" type:"map"` // A key-value map specifying required or optional response parameters that // API Gateway can send back to the caller. A key defines a method response // header name and the associated value is a Boolean flag indicating whether // the method response parameter is required or not. The method response header // names must match the pattern of method.response.header.{name}, where name // is a valid and unique header name. The response parameter names defined here // are available in the integration response to be mapped from an integration // response header expressed in integration.response.header.{name}, a static // value enclosed within a pair of single quotes (e.g., 'application/json'), // or a JSON expression from the back-end response payload in the form of integration.response.body.{JSON-expression}, // where JSON-expression is a valid JSON expression without the $ prefix.) ResponseParameters map[string]bool `locationName:"responseParameters" type:"map"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The method response's status code. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
Request to add a MethodResponse to an existing Method resource.
func (PutMethodResponseInput) MarshalFields ¶
func (s PutMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutMethodResponseInput) String ¶
func (s PutMethodResponseInput) String() string
String returns the string representation
func (*PutMethodResponseInput) Validate ¶
func (s *PutMethodResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutMethodResponseOutput ¶
type PutMethodResponseOutput struct { // Specifies the Model resources used for the response's content-type. Response // models are represented as a key/value map, with a content-type as the key // and a Model name as the value. ResponseModels map[string]string `locationName:"responseModels" type:"map"` // A key-value map specifying required or optional response parameters that // API Gateway can send back to the caller. A key defines a method response // header and the value specifies whether the associated method response header // is required or not. The expression of the key must match the pattern method.response.header.{name}, // where name is a valid and unique header name. API Gateway passes certain // integration response data to the method response headers specified here according // to the mapping you prescribe in the API's IntegrationResponse. The integration // response data that can be mapped include an integration response header expressed // in integration.response.header.{name}, a static value enclosed within a pair // of single quotes (e.g., 'application/json'), or a JSON expression from the // back-end response payload in the form of integration.response.body.{JSON-expression}, // where JSON-expression is a valid JSON expression without the $ prefix.) ResponseParameters map[string]bool `locationName:"responseParameters" type:"map"` // The method response's status code. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents a method response of a given HTTP status code returned to the client. The method response is passed from the back end through the associated integration response that can be transformed using a mapping template.
Example: A MethodResponse instance of an API
Request
The example request retrieves a MethodResponse of the 200 status code.
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T222952Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns 200 OK status and a payload as follows:
{ "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" }
Method, IntegrationResponse, Integration Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (PutMethodResponseOutput) MarshalFields ¶
func (s PutMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutMethodResponseOutput) String ¶
func (s PutMethodResponseOutput) String() string
String returns the string representation
type PutMethodResponseRequest ¶
type PutMethodResponseRequest struct { *aws.Request Input *PutMethodResponseInput Copy func(*PutMethodResponseInput) PutMethodResponseRequest }
PutMethodResponseRequest is the request type for the PutMethodResponse API operation.
func (PutMethodResponseRequest) Send ¶
func (r PutMethodResponseRequest) Send(ctx context.Context) (*PutMethodResponseResponse, error)
Send marshals and sends the PutMethodResponse API request.
type PutMethodResponseResponse ¶
type PutMethodResponseResponse struct { *PutMethodResponseOutput // contains filtered or unexported fields }
PutMethodResponseResponse is the response type for the PutMethodResponse API operation.
func (*PutMethodResponseResponse) SDKResponseMetdata ¶
func (r *PutMethodResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the PutMethodResponse request.
type PutMode ¶
type PutMode string
Enum values for PutMode
func (PutMode) MarshalValue ¶
func (PutMode) MarshalValueBuf ¶
type PutRestApiInput ¶
type PutRestApiInput struct { // [Required] The PUT request body containing external API definitions. Currently, // only OpenAPI definition JSON/YAML files are supported. The maximum size of // the API definition file is 2MB. // // Body is a required field Body []byte `locationName:"body" type:"blob" required:"true"` // A query parameter to indicate whether to rollback the API update (true) or // not (false) when a warning is encountered. The default value is false. FailOnWarnings *bool `location:"querystring" locationName:"failonwarnings" type:"boolean"` // The mode query parameter to specify the update mode. Valid values are "merge" // and "overwrite". By default, the update mode is "merge". Mode PutMode `location:"querystring" locationName:"mode" type:"string" enum:"true"` // Custom header parameters as part of the request. For example, to exclude // DocumentationParts from an imported API, set ignore=documentation as a parameters // value, as in the AWS CLI command of aws apigateway import-rest-api --parameters // ignore=documentation --body 'file:///path/to/imported-api-body.json'. Parameters map[string]string `location:"querystring" locationName:"parameters" type:"map"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
A PUT request to update an existing API, with external API definitions specified as the request body.
func (PutRestApiInput) MarshalFields ¶
func (s PutRestApiInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutRestApiInput) String ¶
func (s PutRestApiInput) String() string
String returns the string representation
func (*PutRestApiInput) Validate ¶
func (s *PutRestApiInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutRestApiOutput ¶
type PutRestApiOutput struct { // 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. ApiKeySource ApiKeySourceType `locationName:"apiKeySource" type:"string" enum:"true"` // The list of binary media types supported by the RestApi. By default, the // RestApi supports only UTF-8-encoded text payloads. BinaryMediaTypes []string `locationName:"binaryMediaTypes" type:"list"` // The timestamp when the API was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The API's description. Description *string `locationName:"description" type:"string"` // The endpoint configuration of this RestApi showing the endpoint types of // the API. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The API's identifier. This identifier is unique across all of your APIs in // API Gateway. Id *string `locationName:"id" type:"string"` // 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. MinimumCompressionSize *int64 `locationName:"minimumCompressionSize" type:"integer"` // The API's name. Name *string `locationName:"name" type:"string"` // A stringified JSON policy document that applies to this RestApi regardless // of the caller and Method configuration. Policy *string `locationName:"policy" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // A version identifier for the API. Version *string `locationName:"version" type:"string"` // The warning messages reported when failonwarnings is turned on during API // import. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
Represents a REST API.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (PutRestApiOutput) MarshalFields ¶
func (s PutRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (PutRestApiOutput) String ¶
func (s PutRestApiOutput) String() string
String returns the string representation
type PutRestApiRequest ¶
type PutRestApiRequest struct { *aws.Request Input *PutRestApiInput Copy func(*PutRestApiInput) PutRestApiRequest }
PutRestApiRequest is the request type for the PutRestApi API operation.
func (PutRestApiRequest) Send ¶
func (r PutRestApiRequest) Send(ctx context.Context) (*PutRestApiResponse, error)
Send marshals and sends the PutRestApi API request.
type PutRestApiResponse ¶
type PutRestApiResponse struct { *PutRestApiOutput // contains filtered or unexported fields }
PutRestApiResponse is the response type for the PutRestApi API operation.
func (*PutRestApiResponse) SDKResponseMetdata ¶
func (r *PutRestApiResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the PutRestApi request.
type QuotaPeriodType ¶
type QuotaPeriodType string
const ( QuotaPeriodTypeDay QuotaPeriodType = "DAY" QuotaPeriodTypeWeek QuotaPeriodType = "WEEK" QuotaPeriodTypeMonth QuotaPeriodType = "MONTH" )
Enum values for QuotaPeriodType
func (QuotaPeriodType) MarshalValue ¶
func (enum QuotaPeriodType) MarshalValue() (string, error)
func (QuotaPeriodType) MarshalValueBuf ¶
func (enum QuotaPeriodType) MarshalValueBuf(b []byte) ([]byte, error)
type QuotaSettings ¶
type QuotaSettings struct { // The maximum number of requests that can be made in a given time period. Limit *int64 `locationName:"limit" type:"integer"` // The number of requests subtracted from the given limit in the initial time // period. Offset *int64 `locationName:"offset" type:"integer"` // The time period in which the limit applies. Valid values are "DAY", "WEEK" // or "MONTH". Period QuotaPeriodType `locationName:"period" type:"string" enum:"true"` // contains filtered or unexported fields }
Quotas configured for a usage plan.
func (QuotaSettings) MarshalFields ¶
func (s QuotaSettings) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (QuotaSettings) String ¶
func (s QuotaSettings) String() string
String returns the string representation
type RequestValidator ¶
type RequestValidator struct { // The identifier of this RequestValidator. Id *string `locationName:"id" type:"string"` // The name of this RequestValidator Name *string `locationName:"name" type:"string"` // A Boolean flag to indicate whether to validate a request body according to // the configured Model schema. ValidateRequestBody *bool `locationName:"validateRequestBody" type:"boolean"` // A Boolean flag to indicate whether to validate request parameters (true) // or not (false). ValidateRequestParameters *bool `locationName:"validateRequestParameters" type:"boolean"` // contains filtered or unexported fields }
A set of validation rules for incoming Method requests.
In OpenAPI, a RequestValidator of an API is defined by the x-amazon-apigateway-request-validators.requestValidator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.requestValidator.html) object. It the referenced using the x-amazon-apigateway-request-validator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validator) property.
Enable Basic Request Validation in API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
func (RequestValidator) MarshalFields ¶
func (s RequestValidator) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (RequestValidator) String ¶
func (s RequestValidator) String() string
String returns the string representation
type Resource ¶
type Resource struct { // The resource's identifier. Id *string `locationName:"id" type:"string"` // The parent resource's identifier. ParentId *string `locationName:"parentId" type:"string"` // The full path for this resource. Path *string `locationName:"path" type:"string"` // The last path segment for this resource. PathPart *string `locationName:"pathPart" type:"string"` // Gets an API resource's method of a given HTTP verb. // // The resource methods are a map of methods indexed by methods' HTTP verbs // enabled on the resource. This method map is included in the 200 OK response // of the GET /restapis/{restapi_id}/resources/{resource_id} or GET /restapis/{restapi_id}/resources/{resource_id}?embed=methods // request. // // Example: Get the GET method of an API resource // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: // application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20170223T031827Z // Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20170223/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", // "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", // "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", // "templated": true } }, "apiKeyRequired": false, "authorizationType": "NONE", // "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { // "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": // "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": // "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": // { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.Content-Type": false }, "statusCode": "200" } // } } // If the OPTIONS is enabled on the resource, you can follow the example here // to get that method. Just replace the GET of the last path segment in the // request URL with OPTIONS. ResourceMethods map[string]Method `locationName:"resourceMethods" type:"map"` // contains filtered or unexported fields }
Represents an API resource.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (Resource) MarshalFields ¶
func (s Resource) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Resource) String ¶
String returns the string representation
type RestApi ¶
type RestApi struct { // 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. ApiKeySource ApiKeySourceType `locationName:"apiKeySource" type:"string" enum:"true"` // The list of binary media types supported by the RestApi. By default, the // RestApi supports only UTF-8-encoded text payloads. BinaryMediaTypes []string `locationName:"binaryMediaTypes" type:"list"` // The timestamp when the API was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The API's description. Description *string `locationName:"description" type:"string"` // The endpoint configuration of this RestApi showing the endpoint types of // the API. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The API's identifier. This identifier is unique across all of your APIs in // API Gateway. Id *string `locationName:"id" type:"string"` // 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. MinimumCompressionSize *int64 `locationName:"minimumCompressionSize" type:"integer"` // The API's name. Name *string `locationName:"name" type:"string"` // A stringified JSON policy document that applies to this RestApi regardless // of the caller and Method configuration. Policy *string `locationName:"policy" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // A version identifier for the API. Version *string `locationName:"version" type:"string"` // The warning messages reported when failonwarnings is turned on during API // import. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
Represents a REST API.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (RestApi) MarshalFields ¶
func (s RestApi) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (RestApi) String ¶
String returns the string representation
type SdkConfigurationProperty ¶
type SdkConfigurationProperty struct { // The default value of an SdkType configuration property. DefaultValue *string `locationName:"defaultValue" type:"string"` // The description of an SdkType configuration property. Description *string `locationName:"description" type:"string"` // The user-friendly name of an SdkType configuration property. FriendlyName *string `locationName:"friendlyName" type:"string"` // The name of a an SdkType configuration property. Name *string `locationName:"name" type:"string"` // A boolean flag of an SdkType configuration property to indicate if the associated // SDK configuration property is required (true) or not (false). Required *bool `locationName:"required" type:"boolean"` // contains filtered or unexported fields }
A configuration property of an SDK type.
func (SdkConfigurationProperty) MarshalFields ¶
func (s SdkConfigurationProperty) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (SdkConfigurationProperty) String ¶
func (s SdkConfigurationProperty) String() string
String returns the string representation
type SdkType ¶
type SdkType struct { // A list of configuration properties of an SdkType. ConfigurationProperties []SdkConfigurationProperty `locationName:"configurationProperties" type:"list"` // The description of an SdkType. Description *string `locationName:"description" type:"string"` // The user-friendly name of an SdkType instance. FriendlyName *string `locationName:"friendlyName" type:"string"` // The identifier of an SdkType instance. Id *string `locationName:"id" type:"string"` // contains filtered or unexported fields }
A type of SDK that API Gateway can generate.
func (SdkType) MarshalFields ¶
func (s SdkType) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (SdkType) String ¶
String returns the string representation
type SecurityPolicy ¶
type SecurityPolicy string
const ( SecurityPolicyTls10 SecurityPolicy = "TLS_1_0" SecurityPolicyTls12 SecurityPolicy = "TLS_1_2" )
Enum values for SecurityPolicy
func (SecurityPolicy) MarshalValue ¶
func (enum SecurityPolicy) MarshalValue() (string, error)
func (SecurityPolicy) MarshalValueBuf ¶
func (enum SecurityPolicy) MarshalValueBuf(b []byte) ([]byte, error)
type Stage ¶
type Stage struct { // Settings for logging access in this stage. AccessLogSettings *AccessLogSettings `locationName:"accessLogSettings" type:"structure"` // Specifies whether a cache cluster is enabled for the stage. CacheClusterEnabled *bool `locationName:"cacheClusterEnabled" type:"boolean"` // The size of the cache cluster for the stage, if enabled. CacheClusterSize CacheClusterSize `locationName:"cacheClusterSize" type:"string" enum:"true"` // The status of the cache cluster for the stage, if enabled. CacheClusterStatus CacheClusterStatus `locationName:"cacheClusterStatus" type:"string" enum:"true"` // Settings for the canary deployment in this stage. CanarySettings *CanarySettings `locationName:"canarySettings" type:"structure"` // The identifier of a client certificate for an API stage. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the stage was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The identifier of the Deployment that the stage points to. DeploymentId *string `locationName:"deploymentId" type:"string"` // The stage's description. Description *string `locationName:"description" type:"string"` // The version of the associated API documentation. DocumentationVersion *string `locationName:"documentationVersion" type:"string"` // The timestamp when the stage last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // A map that defines the method settings for a Stage resource. Keys (designated // as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} // for an individual method override, or /\*/\* for overriding all methods in // the stage. MethodSettings map[string]MethodSetting `locationName:"methodSettings" type:"map"` // The name of the stage is the first path segment in the Uniform Resource Identifier // (URI) of a call to API Gateway. Stage names can only contain alphanumeric // characters, hyphens, and underscores. Maximum length is 128 characters. StageName *string `locationName:"stageName" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // Specifies whether active tracing with X-ray is enabled for the Stage. TracingEnabled *bool `locationName:"tracingEnabled" type:"boolean"` // A map that defines the stage variables for a Stage resource. Variable names // can have alphanumeric and underscore characters, and the values must match // [A-Za-z0-9-._~:/?#&=,]+. Variables map[string]string `locationName:"variables" type:"map"` // The ARN of the WebAcl associated with the Stage. WebAclArn *string `locationName:"webAclArn" type:"string"` // contains filtered or unexported fields }
Represents a unique identifier for a version of a deployed RestApi that is callable by users.
Deploy an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-deploy-api.html)
func (Stage) MarshalFields ¶
func (s Stage) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (Stage) String ¶
String returns the string representation
type StageKey ¶
type StageKey struct { // The string identifier of the associated RestApi. RestApiId *string `locationName:"restApiId" type:"string"` // The stage name associated with the stage key. StageName *string `locationName:"stageName" type:"string"` // contains filtered or unexported fields }
A reference to a unique stage identified in the format {restApiId}/{stage}.
func (StageKey) MarshalFields ¶
func (s StageKey) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (StageKey) String ¶
String returns the string representation
type TagResourceInput ¶
type TagResourceInput struct { // [Required] The ARN of a resource that can be tagged. The resource ARN must // be URL-encoded. // // ResourceArn is a required field ResourceArn *string `location:"uri" locationName:"resource_arn" type:"string" required:"true"` // [Required] 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. // // Tags is a required field Tags map[string]string `locationName:"tags" type:"map" required:"true"` // contains filtered or unexported fields }
Adds or updates a tag on a given resource.
func (TagResourceInput) MarshalFields ¶
func (s TagResourceInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (TagResourceInput) String ¶
func (s TagResourceInput) String() string
String returns the string representation
func (*TagResourceInput) Validate ¶
func (s *TagResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type TagResourceOutput ¶
type TagResourceOutput struct {
// contains filtered or unexported fields
}
func (TagResourceOutput) MarshalFields ¶
func (s TagResourceOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (TagResourceOutput) String ¶
func (s TagResourceOutput) String() string
String returns the string representation
type TagResourceRequest ¶
type TagResourceRequest struct { *aws.Request Input *TagResourceInput Copy func(*TagResourceInput) TagResourceRequest }
TagResourceRequest is the request type for the TagResource API operation.
func (TagResourceRequest) Send ¶
func (r TagResourceRequest) Send(ctx context.Context) (*TagResourceResponse, error)
Send marshals and sends the TagResource API request.
type TagResourceResponse ¶
type TagResourceResponse struct { *TagResourceOutput // contains filtered or unexported fields }
TagResourceResponse is the response type for the TagResource API operation.
func (*TagResourceResponse) SDKResponseMetdata ¶
func (r *TagResourceResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the TagResource request.
type TestInvokeAuthorizerInput ¶
type TestInvokeAuthorizerInput struct { // [Optional] A key-value map of additional context variables. AdditionalContext map[string]string `locationName:"additionalContext" type:"map"` // [Required] Specifies a test invoke authorizer request's Authorizer ID. // // AuthorizerId is a required field AuthorizerId *string `location:"uri" locationName:"authorizer_id" type:"string" required:"true"` // [Optional] The simulated request body of an incoming invocation request. Body *string `locationName:"body" type:"string"` // [Required] A key-value map of headers to simulate an incoming invocation // request. This is where the incoming authorization token, or identity source, // should be specified. Headers map[string]string `locationName:"headers" type:"map"` // [Optional] The headers as a map from string to list of values to simulate // an incoming invocation request. This is where the incoming authorization // token, or identity source, may be specified. MultiValueHeaders map[string][]string `locationName:"multiValueHeaders" type:"map"` // [Optional] The URI path, including query string, of the simulated invocation // request. Use this to specify path parameters and query string parameters. PathWithQueryString *string `locationName:"pathWithQueryString" type:"string"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // A key-value map of stage variables to simulate an invocation on a deployed // Stage. StageVariables map[string]string `locationName:"stageVariables" type:"map"` // contains filtered or unexported fields }
Make a request to simulate the execution of an Authorizer.
func (TestInvokeAuthorizerInput) MarshalFields ¶
func (s TestInvokeAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (TestInvokeAuthorizerInput) String ¶
func (s TestInvokeAuthorizerInput) String() string
String returns the string representation
func (*TestInvokeAuthorizerInput) Validate ¶
func (s *TestInvokeAuthorizerInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type TestInvokeAuthorizerOutput ¶
type TestInvokeAuthorizerOutput struct { Authorization map[string][]string `locationName:"authorization" type:"map"` // The open identity claims (https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims), // with any supported custom attributes, returned from the Cognito Your User // Pool configured for the API. Claims map[string]string `locationName:"claims" type:"map"` // The HTTP status code that the client would have received. Value is 0 if the // authorizer succeeded. ClientStatus *int64 `locationName:"clientStatus" type:"integer"` // The execution latency of the test authorizer request. Latency *int64 `locationName:"latency" type:"long"` // The API Gateway execution log for the test authorizer request. Log *string `locationName:"log" type:"string"` // The JSON policy document returned by the Authorizer Policy *string `locationName:"policy" type:"string"` // The principal identity returned by the Authorizer PrincipalId *string `locationName:"principalId" type:"string"` // contains filtered or unexported fields }
Represents the response of the test invoke request for a custom Authorizer
func (TestInvokeAuthorizerOutput) MarshalFields ¶
func (s TestInvokeAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (TestInvokeAuthorizerOutput) String ¶
func (s TestInvokeAuthorizerOutput) String() string
String returns the string representation
type TestInvokeAuthorizerRequest ¶
type TestInvokeAuthorizerRequest struct { *aws.Request Input *TestInvokeAuthorizerInput Copy func(*TestInvokeAuthorizerInput) TestInvokeAuthorizerRequest }
TestInvokeAuthorizerRequest is the request type for the TestInvokeAuthorizer API operation.
func (TestInvokeAuthorizerRequest) Send ¶
func (r TestInvokeAuthorizerRequest) Send(ctx context.Context) (*TestInvokeAuthorizerResponse, error)
Send marshals and sends the TestInvokeAuthorizer API request.
type TestInvokeAuthorizerResponse ¶
type TestInvokeAuthorizerResponse struct { *TestInvokeAuthorizerOutput // contains filtered or unexported fields }
TestInvokeAuthorizerResponse is the response type for the TestInvokeAuthorizer API operation.
func (*TestInvokeAuthorizerResponse) SDKResponseMetdata ¶
func (r *TestInvokeAuthorizerResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the TestInvokeAuthorizer request.
type TestInvokeMethodInput ¶
type TestInvokeMethodInput struct { // The simulated request body of an incoming invocation request. Body *string `locationName:"body" type:"string"` // A ClientCertificate identifier to use in the test invocation. API Gateway // will use the certificate when making the HTTPS request to the defined back-end // endpoint. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // A key-value map of headers to simulate an incoming invocation request. Headers map[string]string `locationName:"headers" type:"map"` // [Required] Specifies a test invoke method request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // The headers as a map from string to list of values to simulate an incoming // invocation request. MultiValueHeaders map[string][]string `locationName:"multiValueHeaders" type:"map"` // The URI path, including query string, of the simulated invocation request. // Use this to specify path parameters and query string parameters. PathWithQueryString *string `locationName:"pathWithQueryString" type:"string"` // [Required] Specifies a test invoke method request's resource ID. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // A key-value map of stage variables to simulate an invocation on a deployed // Stage. StageVariables map[string]string `locationName:"stageVariables" type:"map"` // contains filtered or unexported fields }
Make a request to simulate the execution of a Method.
func (TestInvokeMethodInput) MarshalFields ¶
func (s TestInvokeMethodInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (TestInvokeMethodInput) String ¶
func (s TestInvokeMethodInput) String() string
String returns the string representation
func (*TestInvokeMethodInput) Validate ¶
func (s *TestInvokeMethodInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type TestInvokeMethodOutput ¶
type TestInvokeMethodOutput struct { // The body of the HTTP response. Body *string `locationName:"body" type:"string"` // The headers of the HTTP response. Headers map[string]string `locationName:"headers" type:"map"` // The execution latency of the test invoke request. Latency *int64 `locationName:"latency" type:"long"` // The API Gateway execution log for the test invoke request. Log *string `locationName:"log" type:"string"` // The headers of the HTTP response as a map from string to list of values. MultiValueHeaders map[string][]string `locationName:"multiValueHeaders" type:"map"` // The HTTP status code. Status *int64 `locationName:"status" type:"integer"` // contains filtered or unexported fields }
Represents the response of the test invoke request in the HTTP method.
Test API using the API Gateway console (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-test-method.html#how-to-test-method-console)
func (TestInvokeMethodOutput) MarshalFields ¶
func (s TestInvokeMethodOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (TestInvokeMethodOutput) String ¶
func (s TestInvokeMethodOutput) String() string
String returns the string representation
type TestInvokeMethodRequest ¶
type TestInvokeMethodRequest struct { *aws.Request Input *TestInvokeMethodInput Copy func(*TestInvokeMethodInput) TestInvokeMethodRequest }
TestInvokeMethodRequest is the request type for the TestInvokeMethod API operation.
func (TestInvokeMethodRequest) Send ¶
func (r TestInvokeMethodRequest) Send(ctx context.Context) (*TestInvokeMethodResponse, error)
Send marshals and sends the TestInvokeMethod API request.
type TestInvokeMethodResponse ¶
type TestInvokeMethodResponse struct { *TestInvokeMethodOutput // contains filtered or unexported fields }
TestInvokeMethodResponse is the response type for the TestInvokeMethod API operation.
func (*TestInvokeMethodResponse) SDKResponseMetdata ¶
func (r *TestInvokeMethodResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the TestInvokeMethod request.
type ThrottleSettings ¶
type ThrottleSettings struct { // The API request burst limit, the maximum rate limit over a time ranging from // one to a few seconds, depending upon whether the underlying token bucket // is at its full capacity. BurstLimit *int64 `locationName:"burstLimit" type:"integer"` // The API request steady-state rate limit. RateLimit *float64 `locationName:"rateLimit" type:"double"` // contains filtered or unexported fields }
The API request rate limits.
func (ThrottleSettings) MarshalFields ¶
func (s ThrottleSettings) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (ThrottleSettings) String ¶
func (s ThrottleSettings) String() string
String returns the string representation
type UnauthorizedCacheControlHeaderStrategy ¶
type UnauthorizedCacheControlHeaderStrategy string
const ( UnauthorizedCacheControlHeaderStrategy = "FAIL_WITH_403" UnauthorizedCacheControlHeaderStrategy = "SUCCEED_WITH_RESPONSE_HEADER" UnauthorizedCacheControlHeaderStrategy = "SUCCEED_WITHOUT_RESPONSE_HEADER" )
Enum values for UnauthorizedCacheControlHeaderStrategy
func (UnauthorizedCacheControlHeaderStrategy) MarshalValue ¶
func (enum UnauthorizedCacheControlHeaderStrategy) MarshalValue() (string, error)
func (UnauthorizedCacheControlHeaderStrategy) MarshalValueBuf ¶
func (enum UnauthorizedCacheControlHeaderStrategy) MarshalValueBuf(b []byte) ([]byte, error)
type UntagResourceInput ¶
type UntagResourceInput struct { // [Required] The ARN of a resource that can be tagged. The resource ARN must // be URL-encoded. // // ResourceArn is a required field ResourceArn *string `location:"uri" locationName:"resource_arn" type:"string" required:"true"` // [Required] The Tag keys to delete. // // TagKeys is a required field TagKeys []string `location:"querystring" locationName:"tagKeys" type:"list" required:"true"` // contains filtered or unexported fields }
Removes a tag from a given resource.
func (UntagResourceInput) MarshalFields ¶
func (s UntagResourceInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UntagResourceInput) String ¶
func (s UntagResourceInput) String() string
String returns the string representation
func (*UntagResourceInput) Validate ¶
func (s *UntagResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UntagResourceOutput ¶
type UntagResourceOutput struct {
// contains filtered or unexported fields
}
func (UntagResourceOutput) MarshalFields ¶
func (s UntagResourceOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UntagResourceOutput) String ¶
func (s UntagResourceOutput) String() string
String returns the string representation
type UntagResourceRequest ¶
type UntagResourceRequest struct { *aws.Request Input *UntagResourceInput Copy func(*UntagResourceInput) UntagResourceRequest }
UntagResourceRequest is the request type for the UntagResource API operation.
func (UntagResourceRequest) Send ¶
func (r UntagResourceRequest) Send(ctx context.Context) (*UntagResourceResponse, error)
Send marshals and sends the UntagResource API request.
type UntagResourceResponse ¶
type UntagResourceResponse struct { *UntagResourceOutput // contains filtered or unexported fields }
UntagResourceResponse is the response type for the UntagResource API operation.
func (*UntagResourceResponse) SDKResponseMetdata ¶
func (r *UntagResourceResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UntagResource request.
type UpdateAccountInput ¶
type UpdateAccountInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // contains filtered or unexported fields }
Requests API Gateway to change information about the current Account resource.
func (UpdateAccountInput) MarshalFields ¶
func (s UpdateAccountInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateAccountInput) String ¶
func (s UpdateAccountInput) String() string
String returns the string representation
type UpdateAccountOutput ¶
type UpdateAccountOutput struct { // The version of the API keys used for the account. ApiKeyVersion *string `locationName:"apiKeyVersion" type:"string"` // The ARN of an Amazon CloudWatch role for the current Account. CloudwatchRoleArn *string `locationName:"cloudwatchRoleArn" type:"string"` // A list of features supported for the account. When usage plans are enabled, // the features list will include an entry of "UsagePlans". Features []string `locationName:"features" type:"list"` // Specifies the API request limits configured for the current Account. ThrottleSettings *ThrottleSettings `locationName:"throttleSettings" type:"structure"` // contains filtered or unexported fields }
Represents an AWS account that is associated with API Gateway.
To view the account info, call GET on this resource.
Error Codes
The following exception may be thrown when the request fails.
UnauthorizedException
NotFoundException
TooManyRequestsException
For detailed error code information, including the corresponding HTTP Status Codes, see API Gateway Error Codes (https://docs.aws.amazon.com/apigateway/api-reference/handling-errors/#api-error-codes)
Example: Get the information about an account.
Request
GET /account HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160531T184618Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns a 200 OK status code and a payload similar to the following:
{ "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/account-apigateway-{rel}.html", "name": "account", "templated": true }, "self": { "href": "/account" }, "account:update": { "href": "/account" } }, "cloudwatchRoleArn": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "throttleSettings": { "rateLimit": 500, "burstLimit": 1000 } }
In addition to making the REST API call directly, you can use the AWS CLI and an AWS SDK to access this resource.
API Gateway Limits (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-limits.html) Developer Guide (https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html), AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-account.html)
func (UpdateAccountOutput) MarshalFields ¶
func (s UpdateAccountOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateAccountOutput) String ¶
func (s UpdateAccountOutput) String() string
String returns the string representation
type UpdateAccountRequest ¶
type UpdateAccountRequest struct { *aws.Request Input *UpdateAccountInput Copy func(*UpdateAccountInput) UpdateAccountRequest }
UpdateAccountRequest is the request type for the UpdateAccount API operation.
func (UpdateAccountRequest) Send ¶
func (r UpdateAccountRequest) Send(ctx context.Context) (*UpdateAccountResponse, error)
Send marshals and sends the UpdateAccount API request.
type UpdateAccountResponse ¶
type UpdateAccountResponse struct { *UpdateAccountOutput // contains filtered or unexported fields }
UpdateAccountResponse is the response type for the UpdateAccount API operation.
func (*UpdateAccountResponse) SDKResponseMetdata ¶
func (r *UpdateAccountResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateAccount request.
type UpdateApiKeyInput ¶
type UpdateApiKeyInput struct { // [Required] The identifier of the ApiKey resource to be updated. // // ApiKey is a required field ApiKey *string `location:"uri" locationName:"api_Key" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // contains filtered or unexported fields }
A request to change information about an ApiKey resource.
func (UpdateApiKeyInput) MarshalFields ¶
func (s UpdateApiKeyInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateApiKeyInput) String ¶
func (s UpdateApiKeyInput) String() string
String returns the string representation
func (*UpdateApiKeyInput) Validate ¶
func (s *UpdateApiKeyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateApiKeyOutput ¶
type UpdateApiKeyOutput struct { // The timestamp when the API Key was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // An AWS Marketplace customer identifier , when integrating with the AWS SaaS // Marketplace. CustomerId *string `locationName:"customerId" type:"string"` // The description of the API Key. Description *string `locationName:"description" type:"string"` // Specifies whether the API Key can be used by callers. Enabled *bool `locationName:"enabled" type:"boolean"` // The identifier of the API Key. Id *string `locationName:"id" type:"string"` // The timestamp when the API Key was last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // The name of the API Key. Name *string `locationName:"name" type:"string"` // A list of Stage resources that are associated with the ApiKey resource. StageKeys []string `locationName:"stageKeys" type:"list"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The value of the API Key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
A resource that can be distributed to callers for executing Method resources that require an API key. API keys can be mapped to any Stage on any RestApi, which indicates that the callers with the API key can make requests to that stage.
Use API Keys (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-api-keys.html)
func (UpdateApiKeyOutput) MarshalFields ¶
func (s UpdateApiKeyOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateApiKeyOutput) String ¶
func (s UpdateApiKeyOutput) String() string
String returns the string representation
type UpdateApiKeyRequest ¶
type UpdateApiKeyRequest struct { *aws.Request Input *UpdateApiKeyInput Copy func(*UpdateApiKeyInput) UpdateApiKeyRequest }
UpdateApiKeyRequest is the request type for the UpdateApiKey API operation.
func (UpdateApiKeyRequest) Send ¶
func (r UpdateApiKeyRequest) Send(ctx context.Context) (*UpdateApiKeyResponse, error)
Send marshals and sends the UpdateApiKey API request.
type UpdateApiKeyResponse ¶
type UpdateApiKeyResponse struct { *UpdateApiKeyOutput // contains filtered or unexported fields }
UpdateApiKeyResponse is the response type for the UpdateApiKey API operation.
func (*UpdateApiKeyResponse) SDKResponseMetdata ¶
func (r *UpdateApiKeyResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateApiKey request.
type UpdateAuthorizerInput ¶
type UpdateAuthorizerInput struct { // [Required] The identifier of the Authorizer resource. // // AuthorizerId is a required field AuthorizerId *string `location:"uri" locationName:"authorizer_id" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to update an existing Authorizer resource.
func (UpdateAuthorizerInput) MarshalFields ¶
func (s UpdateAuthorizerInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateAuthorizerInput) String ¶
func (s UpdateAuthorizerInput) String() string
String returns the string representation
func (*UpdateAuthorizerInput) Validate ¶
func (s *UpdateAuthorizerInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateAuthorizerOutput ¶
type UpdateAuthorizerOutput struct { // Optional customer-defined field, used in OpenAPI imports and exports without // functional impact. AuthType *string `locationName:"authType" type:"string"` // Specifies the required credentials as an IAM role for API Gateway to invoke // the authorizer. To specify an IAM role for API Gateway to assume, use the // role's Amazon Resource Name (ARN). To use resource-based permissions on the // Lambda function, specify null. AuthorizerCredentials *string `locationName:"authorizerCredentials" type:"string"` // The TTL in seconds of cached authorizer results. If it equals 0, authorization // caching is disabled. If it is greater than 0, API Gateway will cache authorizer // responses. If this field is not set, the default value is 300. The maximum // value is 3600, or 1 hour. AuthorizerResultTtlInSeconds *int64 `locationName:"authorizerResultTtlInSeconds" type:"integer"` // Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN or // REQUEST authorizers, this must be a well-formed Lambda function URI, for // example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations. // In general, the URI has this form arn:aws:apigateway:{region}:lambda:path/{service_api}, // where {region} is the same as the region hosting the Lambda function, path // indicates that the remaining substring in the URI should be treated as the // path to the resource, including the initial /. For Lambda functions, this // is usually of the form /2015-03-31/functions/[FunctionARN]/invocations. AuthorizerUri *string `locationName:"authorizerUri" type:"string"` // The identifier for the authorizer resource. Id *string `locationName:"id" type:"string"` // The identity source for which authorization is requested. // * For a TOKEN or COGNITO_USER_POOLS authorizer, this is required and specifies // the request header mapping expression for the custom header holding the // authorization token submitted by the client. For example, if the token // header name is Auth, the header mapping expression is method.request.header.Auth. // // * For the REQUEST authorizer, this is required when authorization caching // is enabled. The value is a comma-separated string of one or more mapping // expressions of the specified request parameters. For example, if an Auth // header, a Name query string parameter are defined as identity sources, // this value is method.request.header.Auth, method.request.querystring.Name. // These parameters will be used to derive the authorization caching key // and to perform runtime validation of the REQUEST authorizer by verifying // all of the identity-related request parameters are present, not null and // non-empty. Only when this is true does the authorizer invoke the authorizer // Lambda function, otherwise, it returns a 401 Unauthorized response without // calling the Lambda function. The valid value is a string of comma-separated // mapping expressions of the specified request parameters. When the authorization // caching is not enabled, this property is optional. IdentitySource *string `locationName:"identitySource" type:"string"` // A validation expression for the incoming identity token. For TOKEN authorizers, // this value is a regular expression. For COGNITO_USER_POOLS authorizers, API // Gateway will match the aud field of the incoming token from the client against // the specified regular expression. It will invoke the authorizer's Lambda // function when there is a match. Otherwise, it will return a 401 Unauthorized // response without calling the Lambda function. The validation expression does // not apply to the REQUEST authorizer. IdentityValidationExpression *string `locationName:"identityValidationExpression" type:"string"` // [Required] The name of the authorizer. Name *string `locationName:"name" type:"string"` // A list of the Amazon Cognito user pool ARNs for the COGNITO_USER_POOLS authorizer. // Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}. // For a TOKEN or REQUEST authorizer, this is not defined. ProviderARNs []string `locationName:"providerARNs" type:"list"` // The authorizer type. Valid values are TOKEN for a Lambda function using a // single authorization token submitted in a custom header, REQUEST for a Lambda // function using incoming request parameters, and COGNITO_USER_POOLS for using // an Amazon Cognito user pool. Type AuthorizerType `locationName:"type" type:"string" enum:"true"` // contains filtered or unexported fields }
Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.
Use Lambda Function as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html) Use Cognito User Pool as Authorizer (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html)
func (UpdateAuthorizerOutput) MarshalFields ¶
func (s UpdateAuthorizerOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateAuthorizerOutput) String ¶
func (s UpdateAuthorizerOutput) String() string
String returns the string representation
type UpdateAuthorizerRequest ¶
type UpdateAuthorizerRequest struct { *aws.Request Input *UpdateAuthorizerInput Copy func(*UpdateAuthorizerInput) UpdateAuthorizerRequest }
UpdateAuthorizerRequest is the request type for the UpdateAuthorizer API operation.
func (UpdateAuthorizerRequest) Send ¶
func (r UpdateAuthorizerRequest) Send(ctx context.Context) (*UpdateAuthorizerResponse, error)
Send marshals and sends the UpdateAuthorizer API request.
type UpdateAuthorizerResponse ¶
type UpdateAuthorizerResponse struct { *UpdateAuthorizerOutput // contains filtered or unexported fields }
UpdateAuthorizerResponse is the response type for the UpdateAuthorizer API operation.
func (*UpdateAuthorizerResponse) SDKResponseMetdata ¶
func (r *UpdateAuthorizerResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateAuthorizer request.
type UpdateBasePathMappingInput ¶
type UpdateBasePathMappingInput struct { // [Required] The base path of the BasePathMapping resource to change. // // To specify an empty base path, set this parameter to '(none)'. // // BasePath is a required field BasePath *string `location:"uri" locationName:"base_path" type:"string" required:"true"` // [Required] The domain name of the BasePathMapping resource to change. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // contains filtered or unexported fields }
A request to change information about the BasePathMapping resource.
func (UpdateBasePathMappingInput) MarshalFields ¶
func (s UpdateBasePathMappingInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateBasePathMappingInput) String ¶
func (s UpdateBasePathMappingInput) String() string
String returns the string representation
func (*UpdateBasePathMappingInput) Validate ¶
func (s *UpdateBasePathMappingInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateBasePathMappingOutput ¶
type UpdateBasePathMappingOutput struct { // The base path name that callers of the API must provide as part of the URL // after the domain name. BasePath *string `locationName:"basePath" type:"string"` // The string identifier of the associated RestApi. RestApiId *string `locationName:"restApiId" type:"string"` // The name of the associated stage. Stage *string `locationName:"stage" type:"string"` // contains filtered or unexported fields }
Represents the base path that callers of the API must provide as part of the URL after the domain name.
A custom domain name plus a BasePathMapping specification identifies a deployed RestApi in a given stage of the owner Account.
Use Custom Domain Names (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (UpdateBasePathMappingOutput) MarshalFields ¶
func (s UpdateBasePathMappingOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateBasePathMappingOutput) String ¶
func (s UpdateBasePathMappingOutput) String() string
String returns the string representation
type UpdateBasePathMappingRequest ¶
type UpdateBasePathMappingRequest struct { *aws.Request Input *UpdateBasePathMappingInput Copy func(*UpdateBasePathMappingInput) UpdateBasePathMappingRequest }
UpdateBasePathMappingRequest is the request type for the UpdateBasePathMapping API operation.
func (UpdateBasePathMappingRequest) Send ¶
func (r UpdateBasePathMappingRequest) Send(ctx context.Context) (*UpdateBasePathMappingResponse, error)
Send marshals and sends the UpdateBasePathMapping API request.
type UpdateBasePathMappingResponse ¶
type UpdateBasePathMappingResponse struct { *UpdateBasePathMappingOutput // contains filtered or unexported fields }
UpdateBasePathMappingResponse is the response type for the UpdateBasePathMapping API operation.
func (*UpdateBasePathMappingResponse) SDKResponseMetdata ¶
func (r *UpdateBasePathMappingResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateBasePathMapping request.
type UpdateClientCertificateInput ¶
type UpdateClientCertificateInput struct { // [Required] The identifier of the ClientCertificate resource to be updated. // // ClientCertificateId is a required field ClientCertificateId *string `location:"uri" locationName:"clientcertificate_id" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // contains filtered or unexported fields }
A request to change information about an ClientCertificate resource.
func (UpdateClientCertificateInput) MarshalFields ¶
func (s UpdateClientCertificateInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateClientCertificateInput) String ¶
func (s UpdateClientCertificateInput) String() string
String returns the string representation
func (*UpdateClientCertificateInput) Validate ¶
func (s *UpdateClientCertificateInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateClientCertificateOutput ¶
type UpdateClientCertificateOutput struct { // The identifier of the client certificate. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the client certificate was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the client certificate. Description *string `locationName:"description" type:"string"` // The timestamp when the client certificate will expire. ExpirationDate *time.Time `locationName:"expirationDate" type:"timestamp"` // The PEM-encoded public key of the client certificate, which can be used to // configure certificate authentication in the integration endpoint . PemEncodedCertificate *string `locationName:"pemEncodedCertificate" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a client certificate used to configure client-side SSL authentication while sending requests to the integration endpoint.
Client certificates are used to authenticate an API by the backend server. To authenticate an API client (or user), use IAM roles and policies, a custom Authorizer or an Amazon Cognito user pool.
Use Client-Side Certificate (https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
func (UpdateClientCertificateOutput) MarshalFields ¶
func (s UpdateClientCertificateOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateClientCertificateOutput) String ¶
func (s UpdateClientCertificateOutput) String() string
String returns the string representation
type UpdateClientCertificateRequest ¶
type UpdateClientCertificateRequest struct { *aws.Request Input *UpdateClientCertificateInput Copy func(*UpdateClientCertificateInput) UpdateClientCertificateRequest }
UpdateClientCertificateRequest is the request type for the UpdateClientCertificate API operation.
func (UpdateClientCertificateRequest) Send ¶
func (r UpdateClientCertificateRequest) Send(ctx context.Context) (*UpdateClientCertificateResponse, error)
Send marshals and sends the UpdateClientCertificate API request.
type UpdateClientCertificateResponse ¶
type UpdateClientCertificateResponse struct { *UpdateClientCertificateOutput // contains filtered or unexported fields }
UpdateClientCertificateResponse is the response type for the UpdateClientCertificate API operation.
func (*UpdateClientCertificateResponse) SDKResponseMetdata ¶
func (r *UpdateClientCertificateResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateClientCertificate request.
type UpdateDeploymentInput ¶
type UpdateDeploymentInput struct { // The replacement identifier for the Deployment resource to change information // about. // // DeploymentId is a required field DeploymentId *string `location:"uri" locationName:"deployment_id" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to change information about a Deployment resource.
func (UpdateDeploymentInput) MarshalFields ¶
func (s UpdateDeploymentInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDeploymentInput) String ¶
func (s UpdateDeploymentInput) String() string
String returns the string representation
func (*UpdateDeploymentInput) Validate ¶
func (s *UpdateDeploymentInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateDeploymentOutput ¶
type UpdateDeploymentOutput struct { // A summary of the RestApi at the date and time that the deployment resource // was created. ApiSummary map[string]map[string]MethodSnapshot `locationName:"apiSummary" type:"map"` // The date and time that the deployment resource was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description for the deployment resource. Description *string `locationName:"description" type:"string"` // The identifier for the deployment resource. Id *string `locationName:"id" type:"string"` // contains filtered or unexported fields }
An immutable representation of a RestApi resource that can be called by users using Stages. A deployment must be associated with a Stage for it to be callable over the Internet.
To create a deployment, call POST on the Deployments resource of a RestApi. To view, update, or delete a deployment, call GET, PATCH, or DELETE on the specified deployment resource (/restapis/{restapi_id}/deployments/{deployment_id}).
RestApi, Deployments, Stage, AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-deployment.html), AWS SDKs (https://aws.amazon.com/tools/)
func (UpdateDeploymentOutput) MarshalFields ¶
func (s UpdateDeploymentOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDeploymentOutput) String ¶
func (s UpdateDeploymentOutput) String() string
String returns the string representation
type UpdateDeploymentRequest ¶
type UpdateDeploymentRequest struct { *aws.Request Input *UpdateDeploymentInput Copy func(*UpdateDeploymentInput) UpdateDeploymentRequest }
UpdateDeploymentRequest is the request type for the UpdateDeployment API operation.
func (UpdateDeploymentRequest) Send ¶
func (r UpdateDeploymentRequest) Send(ctx context.Context) (*UpdateDeploymentResponse, error)
Send marshals and sends the UpdateDeployment API request.
type UpdateDeploymentResponse ¶
type UpdateDeploymentResponse struct { *UpdateDeploymentOutput // contains filtered or unexported fields }
UpdateDeploymentResponse is the response type for the UpdateDeployment API operation.
func (*UpdateDeploymentResponse) SDKResponseMetdata ¶
func (r *UpdateDeploymentResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateDeployment request.
type UpdateDocumentationPartInput ¶
type UpdateDocumentationPartInput struct { // [Required] The identifier of the to-be-updated documentation part. // // DocumentationPartId is a required field DocumentationPartId *string `location:"uri" locationName:"part_id" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Updates an existing documentation part of a given API.
func (UpdateDocumentationPartInput) MarshalFields ¶
func (s UpdateDocumentationPartInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDocumentationPartInput) String ¶
func (s UpdateDocumentationPartInput) String() string
String returns the string representation
func (*UpdateDocumentationPartInput) Validate ¶
func (s *UpdateDocumentationPartInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateDocumentationPartOutput ¶
type UpdateDocumentationPartOutput struct { // The DocumentationPart identifier, generated by API Gateway when the DocumentationPart // is created. Id *string `locationName:"id" type:"string"` // The location of the API entity to which the documentation applies. Valid // fields depend on the targeted API entity type. All the valid location fields // are not required. If not explicitly specified, a valid location field is // treated as a wildcard and associated documentation content may be inherited // by matching entities, unless overridden. Location *DocumentationPartLocation `locationName:"location" type:"structure"` // 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 OpenAPI-compliant documentation-related fields // from the properties map are exported and, hence, published as part of the // API entity definitions, while the original documentation parts are exported // in a OpenAPI extension of x-amazon-apigateway-documentation. Properties *string `locationName:"properties" type:"string"` // contains filtered or unexported fields }
A documentation part for a targeted API entity.
A documentation part consists of a content map (properties) and a target (location). The target specifies an API entity to which the documentation content applies. The supported API entity types are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Valid location fields depend on the API entity type. All valid fields are not required.
The content map is a JSON string of API-specific key-value pairs. Although an API can use any shape for the content map, only the OpenAPI-compliant documentation fields will be injected into the associated API entity definition in the exported OpenAPI definition file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationParts
func (UpdateDocumentationPartOutput) MarshalFields ¶
func (s UpdateDocumentationPartOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDocumentationPartOutput) String ¶
func (s UpdateDocumentationPartOutput) String() string
String returns the string representation
type UpdateDocumentationPartRequest ¶
type UpdateDocumentationPartRequest struct { *aws.Request Input *UpdateDocumentationPartInput Copy func(*UpdateDocumentationPartInput) UpdateDocumentationPartRequest }
UpdateDocumentationPartRequest is the request type for the UpdateDocumentationPart API operation.
func (UpdateDocumentationPartRequest) Send ¶
func (r UpdateDocumentationPartRequest) Send(ctx context.Context) (*UpdateDocumentationPartResponse, error)
Send marshals and sends the UpdateDocumentationPart API request.
type UpdateDocumentationPartResponse ¶
type UpdateDocumentationPartResponse struct { *UpdateDocumentationPartOutput // contains filtered or unexported fields }
UpdateDocumentationPartResponse is the response type for the UpdateDocumentationPart API operation.
func (*UpdateDocumentationPartResponse) SDKResponseMetdata ¶
func (r *UpdateDocumentationPartResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateDocumentationPart request.
type UpdateDocumentationVersionInput ¶
type UpdateDocumentationVersionInput struct { // [Required] The version identifier of the to-be-updated documentation version. // // DocumentationVersion is a required field DocumentationVersion *string `location:"uri" locationName:"doc_version" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The string identifier of the associated RestApi.. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Updates an existing documentation version of an API.
func (UpdateDocumentationVersionInput) MarshalFields ¶
func (s UpdateDocumentationVersionInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDocumentationVersionInput) String ¶
func (s UpdateDocumentationVersionInput) String() string
String returns the string representation
func (*UpdateDocumentationVersionInput) Validate ¶
func (s *UpdateDocumentationVersionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateDocumentationVersionOutput ¶
type UpdateDocumentationVersionOutput struct { // The date when the API documentation snapshot is created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The description of the API documentation snapshot. Description *string `locationName:"description" type:"string"` // The version identifier of the API documentation snapshot. Version *string `locationName:"version" type:"string"` // contains filtered or unexported fields }
A snapshot of the documentation of an API.
Publishing API documentation involves creating a documentation version associated with an API stage and exporting the versioned documentation to an external (e.g., OpenAPI) file.
Documenting an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html), DocumentationPart, DocumentationVersions
func (UpdateDocumentationVersionOutput) MarshalFields ¶
func (s UpdateDocumentationVersionOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDocumentationVersionOutput) String ¶
func (s UpdateDocumentationVersionOutput) String() string
String returns the string representation
type UpdateDocumentationVersionRequest ¶
type UpdateDocumentationVersionRequest struct { *aws.Request Input *UpdateDocumentationVersionInput Copy func(*UpdateDocumentationVersionInput) UpdateDocumentationVersionRequest }
UpdateDocumentationVersionRequest is the request type for the UpdateDocumentationVersion API operation.
func (UpdateDocumentationVersionRequest) Send ¶
func (r UpdateDocumentationVersionRequest) Send(ctx context.Context) (*UpdateDocumentationVersionResponse, error)
Send marshals and sends the UpdateDocumentationVersion API request.
type UpdateDocumentationVersionResponse ¶
type UpdateDocumentationVersionResponse struct { *UpdateDocumentationVersionOutput // contains filtered or unexported fields }
UpdateDocumentationVersionResponse is the response type for the UpdateDocumentationVersion API operation.
func (*UpdateDocumentationVersionResponse) SDKResponseMetdata ¶
func (r *UpdateDocumentationVersionResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateDocumentationVersion request.
type UpdateDomainNameInput ¶
type UpdateDomainNameInput struct { // [Required] The name of the DomainName resource to be changed. // // DomainName is a required field DomainName *string `location:"uri" locationName:"domain_name" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // contains filtered or unexported fields }
A request to change information about the DomainName resource.
func (UpdateDomainNameInput) MarshalFields ¶
func (s UpdateDomainNameInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDomainNameInput) String ¶
func (s UpdateDomainNameInput) String() string
String returns the string representation
func (*UpdateDomainNameInput) Validate ¶
func (s *UpdateDomainNameInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateDomainNameOutput ¶
type UpdateDomainNameOutput struct { // The reference to an AWS-managed certificate that will be used by edge-optimized // endpoint for this domain name. AWS Certificate Manager is the only supported // source. CertificateArn *string `locationName:"certificateArn" type:"string"` // The name of the certificate that will be used by edge-optimized endpoint // for this domain name. CertificateName *string `locationName:"certificateName" type:"string"` // The timestamp when the certificate that was used by edge-optimized endpoint // for this domain name was uploaded. CertificateUploadDate *time.Time `locationName:"certificateUploadDate" type:"timestamp"` // The domain name of the Amazon CloudFront distribution associated with this // custom domain name for an edge-optimized endpoint. You set up this association // when adding a DNS record pointing the custom domain name to this distribution // name. For more information about CloudFront distributions, see the Amazon // CloudFront documentation (https://aws.amazon.com/documentation/cloudfront/). DistributionDomainName *string `locationName:"distributionDomainName" type:"string"` // The region-agnostic Amazon Route 53 Hosted Zone ID of the edge-optimized // endpoint. The valid value is Z2FDTNDATAQYW2 for all the regions. For more // information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). DistributionHostedZoneId *string `locationName:"distributionHostedZoneId" type:"string"` // The custom domain name as an API host name, for example, my-api.example.com. DomainName *string `locationName:"domainName" type:"string"` // The status of the DomainName migration. The valid values are AVAILABLE and // UPDATING. If the status is UPDATING, the domain cannot be modified further // until the existing operation is complete. If it is AVAILABLE, the domain // can be updated. DomainNameStatus DomainNameStatus `locationName:"domainNameStatus" type:"string" enum:"true"` // An optional text message containing detailed information about status of // the DomainName migration. DomainNameStatusMessage *string `locationName:"domainNameStatusMessage" type:"string"` // The endpoint configuration of this DomainName showing the endpoint types // of the domain name. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The reference to an AWS-managed certificate that will be used for validating // the regional domain name. AWS Certificate Manager is the only supported source. RegionalCertificateArn *string `locationName:"regionalCertificateArn" type:"string"` // The name of the certificate that will be used for validating the regional // domain name. RegionalCertificateName *string `locationName:"regionalCertificateName" type:"string"` // The domain name associated with the regional endpoint for this custom domain // name. You set up this association by adding a DNS record that points the // custom domain name to this regional domain name. The regional domain name // is returned by API Gateway when you create a regional endpoint. RegionalDomainName *string `locationName:"regionalDomainName" type:"string"` // The region-specific Amazon Route 53 Hosted Zone ID of the regional endpoint. // For more information, see Set up a Regional Custom Domain Name (https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) // and AWS Regions and Endpoints for API Gateway (https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region). RegionalHostedZoneId *string `locationName:"regionalHostedZoneId" type:"string"` // The Transport Layer Security (TLS) version + cipher suite for this DomainName. // The valid values are TLS_1_0 and TLS_1_2. SecurityPolicy SecurityPolicy `locationName:"securityPolicy" type:"string" enum:"true"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // contains filtered or unexported fields }
Represents a custom domain name as a user-friendly host name of an API (RestApi).
When you deploy an API, API Gateway creates a default host name for the API. This default API host name is of the {restapi-id}.execute-api.{region}.amazonaws.com format. With the default host name, you can access the API's root resource with the URL of https://{restapi-id}.execute-api.{region}.amazonaws.com/{stage}/. When you set up a custom domain name of apis.example.com for this API, you can then access the same resource using the URL of the https://apis.examples.com/myApi, where myApi is the base path mapping (BasePathMapping) of your API under the custom domain name.
Set a Custom Host Name for an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)
func (UpdateDomainNameOutput) MarshalFields ¶
func (s UpdateDomainNameOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateDomainNameOutput) String ¶
func (s UpdateDomainNameOutput) String() string
String returns the string representation
type UpdateDomainNameRequest ¶
type UpdateDomainNameRequest struct { *aws.Request Input *UpdateDomainNameInput Copy func(*UpdateDomainNameInput) UpdateDomainNameRequest }
UpdateDomainNameRequest is the request type for the UpdateDomainName API operation.
func (UpdateDomainNameRequest) Send ¶
func (r UpdateDomainNameRequest) Send(ctx context.Context) (*UpdateDomainNameResponse, error)
Send marshals and sends the UpdateDomainName API request.
type UpdateDomainNameResponse ¶
type UpdateDomainNameResponse struct { *UpdateDomainNameOutput // contains filtered or unexported fields }
UpdateDomainNameResponse is the response type for the UpdateDomainName API operation.
func (*UpdateDomainNameResponse) SDKResponseMetdata ¶
func (r *UpdateDomainNameResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateDomainName request.
type UpdateGatewayResponseInput ¶
type UpdateGatewayResponseInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE // // ResponseType is a required field ResponseType GatewayResponseType `location:"uri" locationName:"response_type" type:"string" required:"true" enum:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Updates a GatewayResponse of a specified response type on the given RestApi.
func (UpdateGatewayResponseInput) MarshalFields ¶
func (s UpdateGatewayResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateGatewayResponseInput) String ¶
func (s UpdateGatewayResponseInput) String() string
String returns the string representation
func (*UpdateGatewayResponseInput) Validate ¶
func (s *UpdateGatewayResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateGatewayResponseOutput ¶
type UpdateGatewayResponseOutput struct { // A Boolean flag to indicate whether this GatewayResponse is the default gateway // response (true) or not (false). A default gateway response is one generated // by API Gateway without any customization by an API developer. DefaultResponse *bool `locationName:"defaultResponse" type:"boolean"` // Response parameters (paths, query strings and headers) of the GatewayResponse // as a string-to-string map of key-value pairs. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Response templates of the GatewayResponse as a string-to-string map of key-value // pairs. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // The response type of the associated GatewayResponse. Valid values are // * ACCESS_DENIED // // * API_CONFIGURATION_ERROR // // * AUTHORIZER_FAILURE // // * AUTHORIZER_CONFIGURATION_ERROR // // * BAD_REQUEST_PARAMETERS // // * BAD_REQUEST_BODY // // * DEFAULT_4XX // // * DEFAULT_5XX // // * EXPIRED_TOKEN // // * INVALID_SIGNATURE // // * INTEGRATION_FAILURE // // * INTEGRATION_TIMEOUT // // * INVALID_API_KEY // // * MISSING_AUTHENTICATION_TOKEN // // * QUOTA_EXCEEDED // // * REQUEST_TOO_LARGE // // * RESOURCE_NOT_FOUND // // * THROTTLED // // * UNAUTHORIZED // // * UNSUPPORTED_MEDIA_TYPE ResponseType GatewayResponseType `locationName:"responseType" type:"string" enum:"true"` // The HTTP status code for this GatewayResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
A gateway response of a given response type and status code, with optional response parameters and mapping templates.
For more information about valid gateway response types, see Gateway Response Types Supported by API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html)
Example: Get a Gateway Response of a given response type
Request
This example shows how to get a gateway response of the MISSING_AUTHENTICATION_TOKEN type.
GET /restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN HTTP/1.1 Host: beta-apigateway.us-east-1.amazonaws.com Content-Type: application/json X-Amz-Date: 20170503T202516Z Authorization: AWS4-HMAC-SHA256 Credential={access-key-id}/20170503/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=1b52460e3159c1a26cff29093855d50ea141c1c5b937528fecaf60f51129697a Cache-Control: no-cache Postman-Token: 3b2a1ce9-c848-2e26-2e2f-9c2caefbed45
The response type is specified as a URL path.
Response
The successful operation returns the 200 OK status code and a payload similar to the following:
{ "_links": { "curies": { "href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-gatewayresponse-{rel}.html", "name": "gatewayresponse", "templated": true }, "self": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:delete": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" }, "gatewayresponse:put": { "href": "/restapis/o81lxisefl/gatewayresponses/{response_type}", "templated": true }, "gatewayresponse:update": { "href": "/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN" } }, "defaultResponse": false, "responseParameters": { "gatewayresponse.header.x-request-path": "method.request.path.petId", "gatewayresponse.header.Access-Control-Allow-Origin": "'a.b.c'", "gatewayresponse.header.x-request-query": "method.request.querystring.q", "gatewayresponse.header.x-request-header": "method.request.header.Accept" }, "responseTemplates": { "application/json": "{\n \"message\": $context.error.messageString,\n \"type\": \"$context.error.responseType\",\n \"stage\": \"$context.stage\",\n \"resourcePath\": \"$context.resourcePath\",\n \"stageVariables.a\": \"$stageVariables.a\",\n \"statusCode\": \"'404'\"\n}" }, "responseType": "MISSING_AUTHENTICATION_TOKEN", "statusCode": "404" }
Customize Gateway Responses (https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html)
func (UpdateGatewayResponseOutput) MarshalFields ¶
func (s UpdateGatewayResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateGatewayResponseOutput) String ¶
func (s UpdateGatewayResponseOutput) String() string
String returns the string representation
type UpdateGatewayResponseRequest ¶
type UpdateGatewayResponseRequest struct { *aws.Request Input *UpdateGatewayResponseInput Copy func(*UpdateGatewayResponseInput) UpdateGatewayResponseRequest }
UpdateGatewayResponseRequest is the request type for the UpdateGatewayResponse API operation.
func (UpdateGatewayResponseRequest) Send ¶
func (r UpdateGatewayResponseRequest) Send(ctx context.Context) (*UpdateGatewayResponseResponse, error)
Send marshals and sends the UpdateGatewayResponse API request.
type UpdateGatewayResponseResponse ¶
type UpdateGatewayResponseResponse struct { *UpdateGatewayResponseOutput // contains filtered or unexported fields }
UpdateGatewayResponseResponse is the response type for the UpdateGatewayResponse API operation.
func (*UpdateGatewayResponseResponse) SDKResponseMetdata ¶
func (r *UpdateGatewayResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateGatewayResponse request.
type UpdateIntegrationInput ¶
type UpdateIntegrationInput struct { // [Required] Represents an update integration request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] Represents an update integration request's resource identifier. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Represents an update integration request.
func (UpdateIntegrationInput) MarshalFields ¶
func (s UpdateIntegrationInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateIntegrationInput) String ¶
func (s UpdateIntegrationInput) String() string
String returns the string representation
func (*UpdateIntegrationInput) Validate ¶
func (s *UpdateIntegrationInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateIntegrationOutput ¶
type UpdateIntegrationOutput struct { // A list of request parameters whose values API Gateway caches. To be valid // values for cacheKeyParameters, these parameters must also be specified for // Method requestParameters. CacheKeyParameters []string `locationName:"cacheKeyParameters" type:"list"` // An API-specific tag group of related cached parameters. To be valid values // for cacheKeyParameters, these parameters must also be specified for Method // requestParameters. CacheNamespace *string `locationName:"cacheNamespace" type:"string"` // The (id (https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id)) // of the VpcLink used for the integration when connectionType=VPC_LINK and // undefined, otherwise. ConnectionId *string `locationName:"connectionId" type:"string"` // The type of the network connection to the integration endpoint. The valid // value is INTERNET for connections through the public routable internet or // VPC_LINK for private connections between API Gateway and a network load balancer // in a VPC. The default value is INTERNET. ConnectionType ConnectionType `locationName:"connectionType" type:"string" enum:"true"` // Specifies how to handle request payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a request payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a request payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the request payload will be passed through // from the method request to integration request without modification, provided // that the passthroughBehavior is configured to support payload pass-through. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // Specifies the credentials required for the integration, if any. For AWS integrations, // three options are available. To specify an IAM Role for API Gateway to assume, // use the role's Amazon Resource Name (ARN). To require that the caller's identity // be passed through from the request, specify the string arn:aws:iam::\*:user/\*. // To use resource-based permissions on supported AWS services, specify null. Credentials *string `locationName:"credentials" type:"string"` // Specifies the integration's HTTP method type. HttpMethod *string `locationName:"httpMethod" type:"string"` // Specifies the integration's responses. // // Example: Get integration responses of a method // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200 // HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // X-Amz-Date: 20160607T191449Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160607/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns 200 OK status and a payload as follows: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } // // Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html) IntegrationResponses map[string]IntegrationResponse `locationName:"integrationResponses" type:"map"` // Specifies how the method request body of an unmapped content type will be // passed through the integration request to the back end without transformation. // A content type is unmapped if no mapping template is defined in the integration // or the content type does not match any of the mapped content types, as specified // in requestTemplates. The valid value is one of the following: // // * WHEN_NO_MATCH: passes the method request body through the integration // request to the back end without transformation when the method request // content type does not match any content type associated with the mapping // templates defined in the integration request. // // * WHEN_NO_TEMPLATES: passes the method request body through the integration // request to the back end without transformation when no mapping template // is defined in the integration request. If a template is defined when this // option is selected, the method request of an unmapped content-type will // be rejected with an HTTP 415 Unsupported Media Type response. // // * NEVER: rejects the method request with an HTTP 415 Unsupported Media // Type response when either the method request content type does not match // any content type associated with the mapping templates defined in the // integration request or no mapping template is defined in the integration // request. PassthroughBehavior *string `locationName:"passthroughBehavior" type:"string"` // A key-value map specifying request parameters that are passed from the method // request to the back end. The key is an integration request parameter name // and the associated value is a method request parameter value or static value // that must be enclosed within single quotes and pre-encoded as required by // the back end. The method request parameter value must match the pattern of // method.request.{location}.{name}, where location is querystring, path, or // header and name must be a valid and unique method request parameter name. RequestParameters map[string]string `locationName:"requestParameters" type:"map"` // Represents a map of Velocity templates that are applied on the request payload // based on the value of the Content-Type header sent by the client. The content // type value is the key in this map, and the template (as a String) is the // value. RequestTemplates map[string]string `locationName:"requestTemplates" type:"map"` // Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 // milliseconds or 29 seconds. TimeoutInMillis *int64 `locationName:"timeoutInMillis" type:"integer"` // Specifies an API method integration type. The valid value is one of the following: // // * AWS: for integrating the API method request with an AWS service action, // including the Lambda function-invoking action. With the Lambda function-invoking // action, this is referred to as the Lambda custom integration. With any // other AWS service action, this is known as AWS integration. // // * AWS_PROXY: for integrating the API method request with the Lambda function-invoking // action with the client request passed through as-is. This integration // is also referred to as the Lambda proxy integration. // // * HTTP: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC. This integration is also // referred to as the HTTP custom integration. // // * HTTP_PROXY: for integrating the API method request with an HTTP endpoint, // including a private HTTP endpoint within a VPC, with the client request // passed through as-is. This is also referred to as the HTTP proxy integration. // // * MOCK: for integrating the API method request with API Gateway as a "loop-back" // endpoint without invoking any backend. // // For the HTTP and HTTP proxy integrations, each integration can specify a // protocol (http/https), port and path. Standard 80 and 443 ports are supported // as well as custom ports above 1024. An HTTP or HTTP proxy integration with // a connectionType of VPC_LINK is referred to as a private integration and // uses a VpcLink to connect API Gateway to a network load balancer of a VPC. Type IntegrationType `locationName:"type" type:"string" enum:"true"` // Specifies Uniform Resource Identifier (URI) of the integration endpoint. // // * For HTTP or HTTP_PROXY integrations, the URI must be a fully formed, // encoded HTTP(S) URL according to the RFC-3986 specification (https://en.wikipedia.org/wiki/Uniform_Resource_Identifier), // for either standard integration, where connectionType is not VPC_LINK, // or private integration, where connectionType is VPC_LINK. For a private // HTTP integration, the URI is not used for routing. // // * For AWS or AWS_PROXY integrations, the URI is of the form arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api}. // Here, {Region} is the API Gateway region (e.g., us-east-1); {service} // is the name of the integrated AWS service (e.g., s3); and {subdomain} // is a designated subdomain supported by certain AWS service for fast host-name // lookup. action can be used for an AWS service action-based API, using // an Action={name}&{p1}={v1}&p2={v2}... query string. The ensuing {service_api} // refers to a supported action {name} plus any required input parameters. // Alternatively, path can be used for an AWS service path-based API. The // ensuing service_api refers to the path to an AWS service resource, including // the region of the integrated AWS service, if applicable. For example, // for integration with the S3 API of GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html), // the uri can be either arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} // or arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key} Uri *string `locationName:"uri" type:"string"` // contains filtered or unexported fields }
Represents an HTTP, HTTP_PROXY, AWS, AWS_PROXY, or Mock integration.
In the API Gateway console, the built-in Lambda integration is an AWS integration.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (UpdateIntegrationOutput) MarshalFields ¶
func (s UpdateIntegrationOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateIntegrationOutput) String ¶
func (s UpdateIntegrationOutput) String() string
String returns the string representation
type UpdateIntegrationRequest ¶
type UpdateIntegrationRequest struct { *aws.Request Input *UpdateIntegrationInput Copy func(*UpdateIntegrationInput) UpdateIntegrationRequest }
UpdateIntegrationRequest is the request type for the UpdateIntegration API operation.
func (UpdateIntegrationRequest) Send ¶
func (r UpdateIntegrationRequest) Send(ctx context.Context) (*UpdateIntegrationResponse, error)
Send marshals and sends the UpdateIntegration API request.
type UpdateIntegrationResponse ¶
type UpdateIntegrationResponse struct { *UpdateIntegrationOutput // contains filtered or unexported fields }
UpdateIntegrationResponse is the response type for the UpdateIntegration API operation.
func (*UpdateIntegrationResponse) SDKResponseMetdata ¶
func (r *UpdateIntegrationResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateIntegration request.
type UpdateIntegrationResponseInput ¶
type UpdateIntegrationResponseInput struct { // [Required] Specifies an update integration response request's HTTP method. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] Specifies an update integration response request's resource identifier. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] Specifies an update integration response request's status code. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
Represents an update integration response request.
func (UpdateIntegrationResponseInput) MarshalFields ¶
func (s UpdateIntegrationResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateIntegrationResponseInput) String ¶
func (s UpdateIntegrationResponseInput) String() string
String returns the string representation
func (*UpdateIntegrationResponseInput) Validate ¶
func (s *UpdateIntegrationResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateIntegrationResponseOutput ¶
type UpdateIntegrationResponseOutput struct { // Specifies how to handle response payload content type conversions. Supported // values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors: // // * CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded // string to the corresponding binary blob. // // * CONVERT_TO_TEXT: Converts a response payload from a binary blob to a // Base64-encoded string. // // If this property is not defined, the response payload will be passed through // from the integration response to the method response without modification. ContentHandling ContentHandlingStrategy `locationName:"contentHandling" type:"string" enum:"true"` // A key-value map specifying response parameters that are passed to the method // response from the back end. The key is a method response header parameter // name and the mapped value is an integration response header value, a static // value enclosed within a pair of single quotes, or a JSON expression from // the integration response body. The mapping key must match the pattern of // method.response.header.{name}, where name is a valid and unique header name. // The mapped non-static value must match the pattern of integration.response.header.{name} // or integration.response.body.{JSON-expression}, where name is a valid and // unique response header name and JSON-expression is a valid JSON expression // without the $ prefix. ResponseParameters map[string]string `locationName:"responseParameters" type:"map"` // Specifies the templates used to transform the integration response body. // Response templates are represented as a key/value map, with a content-type // as the key and a template as the value. ResponseTemplates map[string]string `locationName:"responseTemplates" type:"map"` // Specifies the regular expression (regex) pattern used to choose an integration // response based on the response from the back end. For example, if the success // response returns nothing and the error response returns some string, you // could use the .+ regex to match error response. However, make sure that the // error response does not contain any newline (\n) character in such cases. // If the back end is an AWS Lambda function, the AWS Lambda function error // header is matched. For all other HTTP and AWS back ends, the HTTP status // code is matched. SelectionPattern *string `locationName:"selectionPattern" type:"string"` // Specifies the status code that is used to map the integration response to // an existing MethodResponse. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents an integration response. The status code must map to an existing MethodResponse, and parameters and templates can be used to transform the back-end response.
Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (UpdateIntegrationResponseOutput) MarshalFields ¶
func (s UpdateIntegrationResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateIntegrationResponseOutput) String ¶
func (s UpdateIntegrationResponseOutput) String() string
String returns the string representation
type UpdateIntegrationResponseRequest ¶
type UpdateIntegrationResponseRequest struct { *aws.Request Input *UpdateIntegrationResponseInput Copy func(*UpdateIntegrationResponseInput) UpdateIntegrationResponseRequest }
UpdateIntegrationResponseRequest is the request type for the UpdateIntegrationResponse API operation.
func (UpdateIntegrationResponseRequest) Send ¶
func (r UpdateIntegrationResponseRequest) Send(ctx context.Context) (*UpdateIntegrationResponseResponse, error)
Send marshals and sends the UpdateIntegrationResponse API request.
type UpdateIntegrationResponseResponse ¶
type UpdateIntegrationResponseResponse struct { *UpdateIntegrationResponseOutput // contains filtered or unexported fields }
UpdateIntegrationResponseResponse is the response type for the UpdateIntegrationResponse API operation.
func (*UpdateIntegrationResponseResponse) SDKResponseMetdata ¶
func (r *UpdateIntegrationResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateIntegrationResponse request.
type UpdateMethodInput ¶
type UpdateMethodInput struct { // [Required] The HTTP verb of the Method resource. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The Resource identifier for the Method resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to update an existing Method resource.
func (UpdateMethodInput) MarshalFields ¶
func (s UpdateMethodInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateMethodInput) String ¶
func (s UpdateMethodInput) String() string
String returns the string representation
func (*UpdateMethodInput) Validate ¶
func (s *UpdateMethodInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateMethodOutput ¶
type UpdateMethodOutput struct { // A boolean flag specifying whether a valid ApiKey is required to invoke this // method. ApiKeyRequired *bool `locationName:"apiKeyRequired" type:"boolean"` // A list of authorization scopes configured on the method. The scopes are used // with a COGNITO_USER_POOLS authorizer to authorize the method invocation. // The authorization works by matching the method scopes against the scopes // parsed from the access token in the incoming request. The method invocation // is authorized if any method scopes matches a claimed scope in the access // token. Otherwise, the invocation is not authorized. When the method scope // is configured, the client must provide an access token instead of an identity // token for authorization purposes. AuthorizationScopes []string `locationName:"authorizationScopes" type:"list"` // The method's authorization type. Valid values are NONE for open access, AWS_IAM // for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS // for using a Cognito user pool. AuthorizationType *string `locationName:"authorizationType" type:"string"` // The identifier of an Authorizer to use on this method. The authorizationType // must be CUSTOM. AuthorizerId *string `locationName:"authorizerId" type:"string"` // The method's HTTP verb. HttpMethod *string `locationName:"httpMethod" type:"string"` // Gets the method's integration responsible for passing the client-submitted // request to the back end and performing necessary transformations to make // the request compliant with the back end. // // Example: // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T213210Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true } ], "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" }, "integration:delete": // { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "0cjtch", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestTemplates": { "application/json": // "{\n \"a\": \"$input.params('operand1')\",\n \"b\": \"$input.params('operand2')\", // \n \"op\": \"$input.params('operator')\" \n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-west-2:lambda:path//2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:Calc/invocations", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.operator": "integration.response.body.op", // "method.response.header.operand_2": "integration.response.body.b", "method.response.header.operand_1": // "integration.response.body.a" }, "responseTemplates": { "application/json": // "#set($res = $input.path('$'))\n{\n \"result\": \"$res.a, $res.b, $res.op // => $res.c\",\n \"a\" : \"$res.a\",\n \"b\" : \"$res.b\",\n \"op\" : \"$res.op\",\n // \"c\" : \"$res.c\"\n}" }, "selectionPattern": "", "statusCode": "200" } // } } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-integration.html) MethodIntegration *Integration `locationName:"methodIntegration" type:"structure"` // Gets a method response associated with a given HTTP status code. // // The collection of method responses are encapsulated in a key-value map, where // the key is a response's HTTP status code and the value is a MethodResponse // resource that specifies the response returned to the caller from the back // end through the integration response. // // Example: Get a 200 OK response of a GET method // // Request // GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200 HTTP/1.1 // Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com // Content-Length: 117 X-Amz-Date: 20160613T215008Z Authorization: AWS4-HMAC-SHA256 // Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // // The successful response returns a 200 OK status code and a payload similar // to the following: // { "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200", // "title": "200" }, "methodresponse:delete": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.operator": false, "method.response.header.operand_2": // false, "method.response.header.operand_1": false }, "statusCode": "200" // } // // AWS CLI (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-method-response.html) MethodResponses map[string]MethodResponse `locationName:"methodResponses" type:"map"` // A human-friendly operation identifier for the method. For example, you can // assign the operationName of ListPets for the GET /pets method in the PetStore // example. OperationName *string `locationName:"operationName" type:"string"` // A key-value map specifying data schemas, represented by Model resources, // (as the mapped value) of the request payloads of given content types (as // the mapping key). RequestModels map[string]string `locationName:"requestModels" type:"map"` // A key-value map defining required or optional method request parameters that // can be accepted by API Gateway. A key is a method request parameter name // matching the pattern of method.request.{location}.{name}, where location // is querystring, path, or header and name is a valid and unique parameter // name. The value associated with the key is a Boolean flag indicating whether // the parameter is required (true) or optional (false). The method request // parameter names defined here are available in Integration to be mapped to // integration request parameters or templates. RequestParameters map[string]bool `locationName:"requestParameters" type:"map"` // The identifier of a RequestValidator for request validation. RequestValidatorId *string `locationName:"requestValidatorId" type:"string"` // contains filtered or unexported fields }
Represents a client-facing interface by which the client calls the API to access back-end resources. A Method resource is integrated with an Integration resource. Both consist of a request and one or more responses. The method request takes the client input that is passed to the back end through the integration request. A method response returns the output from the back end to the client through an integration response. A method request is embodied in a Method resource, whereas an integration request is embodied in an Integration resource. On the other hand, a method response is represented by a MethodResponse resource, whereas an integration response is represented by an IntegrationResponse resource.
Example: Retrive the GET method on a specified resource
Request
The following example request retrieves the information about the GET method on an API resource (3kzxbg5sa2) of an API (fugvjdxtri).
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T210259Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns a 200 OK status code and a payload similar to the following:
{ "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", "templated": true } }, "apiKeyRequired": true, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": { "integration:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" }, "integrationresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E\")" }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" } } }
In the example above, the response template for the 200 OK response maps the JSON output from the ListStreams action in the back end to an XML output. The mapping template is URL-encoded as %3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E and the output is decoded using the $util.urlDecode() (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#util-templat-reference) helper function.
MethodResponse, Integration, IntegrationResponse, Resource, Set up an API's method (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-method-settings.html)
func (UpdateMethodOutput) MarshalFields ¶
func (s UpdateMethodOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateMethodOutput) String ¶
func (s UpdateMethodOutput) String() string
String returns the string representation
type UpdateMethodRequest ¶
type UpdateMethodRequest struct { *aws.Request Input *UpdateMethodInput Copy func(*UpdateMethodInput) UpdateMethodRequest }
UpdateMethodRequest is the request type for the UpdateMethod API operation.
func (UpdateMethodRequest) Send ¶
func (r UpdateMethodRequest) Send(ctx context.Context) (*UpdateMethodResponse, error)
Send marshals and sends the UpdateMethod API request.
type UpdateMethodResponse ¶
type UpdateMethodResponse struct { *UpdateMethodOutput // contains filtered or unexported fields }
UpdateMethodResponse is the response type for the UpdateMethod API operation.
func (*UpdateMethodResponse) SDKResponseMetdata ¶
func (r *UpdateMethodResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateMethod request.
type UpdateMethodResponseInput ¶
type UpdateMethodResponseInput struct { // [Required] The HTTP verb of the Method resource. // // HttpMethod is a required field HttpMethod *string `location:"uri" locationName:"http_method" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The Resource identifier for the MethodResponse resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The status code for the MethodResponse resource. // // StatusCode is a required field StatusCode *string `location:"uri" locationName:"status_code" type:"string" required:"true"` // contains filtered or unexported fields }
A request to update an existing MethodResponse resource.
func (UpdateMethodResponseInput) MarshalFields ¶
func (s UpdateMethodResponseInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateMethodResponseInput) String ¶
func (s UpdateMethodResponseInput) String() string
String returns the string representation
func (*UpdateMethodResponseInput) Validate ¶
func (s *UpdateMethodResponseInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateMethodResponseOutput ¶
type UpdateMethodResponseOutput struct { // Specifies the Model resources used for the response's content-type. Response // models are represented as a key/value map, with a content-type as the key // and a Model name as the value. ResponseModels map[string]string `locationName:"responseModels" type:"map"` // A key-value map specifying required or optional response parameters that // API Gateway can send back to the caller. A key defines a method response // header and the value specifies whether the associated method response header // is required or not. The expression of the key must match the pattern method.response.header.{name}, // where name is a valid and unique header name. API Gateway passes certain // integration response data to the method response headers specified here according // to the mapping you prescribe in the API's IntegrationResponse. The integration // response data that can be mapped include an integration response header expressed // in integration.response.header.{name}, a static value enclosed within a pair // of single quotes (e.g., 'application/json'), or a JSON expression from the // back-end response payload in the form of integration.response.body.{JSON-expression}, // where JSON-expression is a valid JSON expression without the $ prefix.) ResponseParameters map[string]bool `locationName:"responseParameters" type:"map"` // The method response's status code. StatusCode *string `locationName:"statusCode" type:"string"` // contains filtered or unexported fields }
Represents a method response of a given HTTP status code returned to the client. The method response is passed from the back end through the associated integration response that can be transformed using a mapping template.
Example: A MethodResponse instance of an API
Request
The example request retrieves a MethodResponse of the 200 status code.
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T222952Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns 200 OK status and a payload as follows:
{ "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" }
Method, IntegrationResponse, Integration Creating an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (UpdateMethodResponseOutput) MarshalFields ¶
func (s UpdateMethodResponseOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateMethodResponseOutput) String ¶
func (s UpdateMethodResponseOutput) String() string
String returns the string representation
type UpdateMethodResponseRequest ¶
type UpdateMethodResponseRequest struct { *aws.Request Input *UpdateMethodResponseInput Copy func(*UpdateMethodResponseInput) UpdateMethodResponseRequest }
UpdateMethodResponseRequest is the request type for the UpdateMethodResponse API operation.
func (UpdateMethodResponseRequest) Send ¶
func (r UpdateMethodResponseRequest) Send(ctx context.Context) (*UpdateMethodResponseResponse, error)
Send marshals and sends the UpdateMethodResponse API request.
type UpdateMethodResponseResponse ¶
type UpdateMethodResponseResponse struct { *UpdateMethodResponseOutput // contains filtered or unexported fields }
UpdateMethodResponseResponse is the response type for the UpdateMethodResponse API operation.
func (*UpdateMethodResponseResponse) SDKResponseMetdata ¶
func (r *UpdateMethodResponseResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateMethodResponse request.
type UpdateModelInput ¶
type UpdateModelInput struct { // [Required] The name of the model to update. // // ModelName is a required field ModelName *string `location:"uri" locationName:"model_name" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to update an existing model in an existing RestApi resource.
func (UpdateModelInput) MarshalFields ¶
func (s UpdateModelInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateModelInput) String ¶
func (s UpdateModelInput) String() string
String returns the string representation
func (*UpdateModelInput) Validate ¶
func (s *UpdateModelInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateModelOutput ¶
type UpdateModelOutput struct { // The content-type for the model. ContentType *string `locationName:"contentType" type:"string"` // The description of the model. Description *string `locationName:"description" type:"string"` // The identifier for the model resource. Id *string `locationName:"id" type:"string"` // The name of the model. Must be an alphanumeric string. Name *string `locationName:"name" type:"string"` // The schema for the model. For application/json models, this should be JSON // schema draft 4 (https://tools.ietf.org/html/draft-zyp-json-schema-04) model. // Do not include "\*/" characters in the description of any properties because // such "\*/" characters may be interpreted as the closing marker for comments // in some languages, such as Java or JavaScript, causing the installation of // your API's SDK generated by API Gateway to fail. Schema *string `locationName:"schema" type:"string"` // contains filtered or unexported fields }
Represents the data structure of a method's request or response payload.
A request model defines the data structure of the client-supplied request payload. A response model defines the data structure of the response payload returned by the back end. Although not required, models are useful for mapping payloads between the front end and back end.
A model is used for generating an API's SDK, validating the input request body, and creating a skeletal mapping template.
Method, MethodResponse, Models and Mappings (https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html)
func (UpdateModelOutput) MarshalFields ¶
func (s UpdateModelOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateModelOutput) String ¶
func (s UpdateModelOutput) String() string
String returns the string representation
type UpdateModelRequest ¶
type UpdateModelRequest struct { *aws.Request Input *UpdateModelInput Copy func(*UpdateModelInput) UpdateModelRequest }
UpdateModelRequest is the request type for the UpdateModel API operation.
func (UpdateModelRequest) Send ¶
func (r UpdateModelRequest) Send(ctx context.Context) (*UpdateModelResponse, error)
Send marshals and sends the UpdateModel API request.
type UpdateModelResponse ¶
type UpdateModelResponse struct { *UpdateModelOutput // contains filtered or unexported fields }
UpdateModelResponse is the response type for the UpdateModel API operation.
func (*UpdateModelResponse) SDKResponseMetdata ¶
func (r *UpdateModelResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateModel request.
type UpdateRequestValidatorInput ¶
type UpdateRequestValidatorInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The identifier of RequestValidator to be updated. // // RequestValidatorId is a required field RequestValidatorId *string `location:"uri" locationName:"requestvalidator_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Updates a RequestValidator of a given RestApi.
func (UpdateRequestValidatorInput) MarshalFields ¶
func (s UpdateRequestValidatorInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateRequestValidatorInput) String ¶
func (s UpdateRequestValidatorInput) String() string
String returns the string representation
func (*UpdateRequestValidatorInput) Validate ¶
func (s *UpdateRequestValidatorInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateRequestValidatorOutput ¶
type UpdateRequestValidatorOutput struct { // The identifier of this RequestValidator. Id *string `locationName:"id" type:"string"` // The name of this RequestValidator Name *string `locationName:"name" type:"string"` // A Boolean flag to indicate whether to validate a request body according to // the configured Model schema. ValidateRequestBody *bool `locationName:"validateRequestBody" type:"boolean"` // A Boolean flag to indicate whether to validate request parameters (true) // or not (false). ValidateRequestParameters *bool `locationName:"validateRequestParameters" type:"boolean"` // contains filtered or unexported fields }
A set of validation rules for incoming Method requests.
In OpenAPI, a RequestValidator of an API is defined by the x-amazon-apigateway-request-validators.requestValidator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.requestValidator.html) object. It the referenced using the x-amazon-apigateway-request-validator (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validator) property.
Enable Basic Request Validation in API Gateway (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
func (UpdateRequestValidatorOutput) MarshalFields ¶
func (s UpdateRequestValidatorOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateRequestValidatorOutput) String ¶
func (s UpdateRequestValidatorOutput) String() string
String returns the string representation
type UpdateRequestValidatorRequest ¶
type UpdateRequestValidatorRequest struct { *aws.Request Input *UpdateRequestValidatorInput Copy func(*UpdateRequestValidatorInput) UpdateRequestValidatorRequest }
UpdateRequestValidatorRequest is the request type for the UpdateRequestValidator API operation.
func (UpdateRequestValidatorRequest) Send ¶
func (r UpdateRequestValidatorRequest) Send(ctx context.Context) (*UpdateRequestValidatorResponse, error)
Send marshals and sends the UpdateRequestValidator API request.
type UpdateRequestValidatorResponse ¶
type UpdateRequestValidatorResponse struct { *UpdateRequestValidatorOutput // contains filtered or unexported fields }
UpdateRequestValidatorResponse is the response type for the UpdateRequestValidator API operation.
func (*UpdateRequestValidatorResponse) SDKResponseMetdata ¶
func (r *UpdateRequestValidatorResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateRequestValidator request.
type UpdateResourceInput ¶
type UpdateResourceInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The identifier of the Resource resource. // // ResourceId is a required field ResourceId *string `location:"uri" locationName:"resource_id" type:"string" required:"true"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to change information about a Resource resource.
func (UpdateResourceInput) MarshalFields ¶
func (s UpdateResourceInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateResourceInput) String ¶
func (s UpdateResourceInput) String() string
String returns the string representation
func (*UpdateResourceInput) Validate ¶
func (s *UpdateResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateResourceOutput ¶
type UpdateResourceOutput struct { // The resource's identifier. Id *string `locationName:"id" type:"string"` // The parent resource's identifier. ParentId *string `locationName:"parentId" type:"string"` // The full path for this resource. Path *string `locationName:"path" type:"string"` // The last path segment for this resource. PathPart *string `locationName:"pathPart" type:"string"` // Gets an API resource's method of a given HTTP verb. // // The resource methods are a map of methods indexed by methods' HTTP verbs // enabled on the resource. This method map is included in the 200 OK response // of the GET /restapis/{restapi_id}/resources/{resource_id} or GET /restapis/{restapi_id}/resources/{resource_id}?embed=methods // request. // // Example: Get the GET method of an API resource // // Request // GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: // application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20170223T031827Z // Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20170223/us-east-1/apigateway/aws4_request, // SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} // Response // { "_links": { "curies": [ { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html", // "name": "integration", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html", // "name": "integrationresponse", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html", // "name": "method", "templated": true }, { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", // "name": "methodresponse", "templated": true } ], "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", // "name": "GET", "title": "GET" }, "integration:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "method:integration": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "method:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "method:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" // }, "methodresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}", // "templated": true } }, "apiKeyRequired": false, "authorizationType": "NONE", // "httpMethod": "GET", "_embedded": { "method:integration": { "_links": { // "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integration:responses": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integration:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" // }, "integrationresponse:put": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}", // "templated": true } }, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", // "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": // "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": { "integration.request.header.Content-Type": // "'application/x-amz-json-1.1'" }, "requestTemplates": { "application/json": // "{\n}" }, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", // "_embedded": { "integration:responses": { "_links": { "self": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", // "name": "200", "title": "200" }, "integrationresponse:delete": { "href": // "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // }, "integrationresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" // } }, "responseParameters": { "method.response.header.Content-Type": "'application/xml'" // }, "responseTemplates": { "application/json": "$util.urlDecode(\"%3CkinesisStreams%3E#foreach($stream // in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\")\n" // }, "statusCode": "200" } } }, "method:responses": { "_links": { "self": // { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", // "name": "200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" // } }, "responseModels": { "application/json": "Empty" }, "responseParameters": // { "method.response.header.Content-Type": false }, "statusCode": "200" } // } } // If the OPTIONS is enabled on the resource, you can follow the example here // to get that method. Just replace the GET of the last path segment in the // request URL with OPTIONS. ResourceMethods map[string]Method `locationName:"resourceMethods" type:"map"` // contains filtered or unexported fields }
Represents an API resource.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (UpdateResourceOutput) MarshalFields ¶
func (s UpdateResourceOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateResourceOutput) String ¶
func (s UpdateResourceOutput) String() string
String returns the string representation
type UpdateResourceRequest ¶
type UpdateResourceRequest struct { *aws.Request Input *UpdateResourceInput Copy func(*UpdateResourceInput) UpdateResourceRequest }
UpdateResourceRequest is the request type for the UpdateResource API operation.
func (UpdateResourceRequest) Send ¶
func (r UpdateResourceRequest) Send(ctx context.Context) (*UpdateResourceResponse, error)
Send marshals and sends the UpdateResource API request.
type UpdateResourceResponse ¶
type UpdateResourceResponse struct { *UpdateResourceOutput // contains filtered or unexported fields }
UpdateResourceResponse is the response type for the UpdateResource API operation.
func (*UpdateResourceResponse) SDKResponseMetdata ¶
func (r *UpdateResourceResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateResource request.
type UpdateRestApiInput ¶
type UpdateRestApiInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // contains filtered or unexported fields }
Request to update an existing RestApi resource in your collection.
func (UpdateRestApiInput) MarshalFields ¶
func (s UpdateRestApiInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateRestApiInput) String ¶
func (s UpdateRestApiInput) String() string
String returns the string representation
func (*UpdateRestApiInput) Validate ¶
func (s *UpdateRestApiInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateRestApiOutput ¶
type UpdateRestApiOutput struct { // 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. ApiKeySource ApiKeySourceType `locationName:"apiKeySource" type:"string" enum:"true"` // The list of binary media types supported by the RestApi. By default, the // RestApi supports only UTF-8-encoded text payloads. BinaryMediaTypes []string `locationName:"binaryMediaTypes" type:"list"` // The timestamp when the API was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The API's description. Description *string `locationName:"description" type:"string"` // The endpoint configuration of this RestApi showing the endpoint types of // the API. EndpointConfiguration *EndpointConfiguration `locationName:"endpointConfiguration" type:"structure"` // The API's identifier. This identifier is unique across all of your APIs in // API Gateway. Id *string `locationName:"id" type:"string"` // 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. MinimumCompressionSize *int64 `locationName:"minimumCompressionSize" type:"integer"` // The API's name. Name *string `locationName:"name" type:"string"` // A stringified JSON policy document that applies to this RestApi regardless // of the caller and Method configuration. Policy *string `locationName:"policy" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // A version identifier for the API. Version *string `locationName:"version" type:"string"` // The warning messages reported when failonwarnings is turned on during API // import. Warnings []string `locationName:"warnings" type:"list"` // contains filtered or unexported fields }
Represents a REST API.
Create an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html)
func (UpdateRestApiOutput) MarshalFields ¶
func (s UpdateRestApiOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateRestApiOutput) String ¶
func (s UpdateRestApiOutput) String() string
String returns the string representation
type UpdateRestApiRequest ¶
type UpdateRestApiRequest struct { *aws.Request Input *UpdateRestApiInput Copy func(*UpdateRestApiInput) UpdateRestApiRequest }
UpdateRestApiRequest is the request type for the UpdateRestApi API operation.
func (UpdateRestApiRequest) Send ¶
func (r UpdateRestApiRequest) Send(ctx context.Context) (*UpdateRestApiResponse, error)
Send marshals and sends the UpdateRestApi API request.
type UpdateRestApiResponse ¶
type UpdateRestApiResponse struct { *UpdateRestApiOutput // contains filtered or unexported fields }
UpdateRestApiResponse is the response type for the UpdateRestApi API operation.
func (*UpdateRestApiResponse) SDKResponseMetdata ¶
func (r *UpdateRestApiResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateRestApi request.
type UpdateStageInput ¶
type UpdateStageInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The string identifier of the associated RestApi. // // RestApiId is a required field RestApiId *string `location:"uri" locationName:"restapi_id" type:"string" required:"true"` // [Required] The name of the Stage resource to change information about. // // StageName is a required field StageName *string `location:"uri" locationName:"stage_name" type:"string" required:"true"` // contains filtered or unexported fields }
Requests API Gateway to change information about a Stage resource.
func (UpdateStageInput) MarshalFields ¶
func (s UpdateStageInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateStageInput) String ¶
func (s UpdateStageInput) String() string
String returns the string representation
func (*UpdateStageInput) Validate ¶
func (s *UpdateStageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateStageOutput ¶
type UpdateStageOutput struct { // Settings for logging access in this stage. AccessLogSettings *AccessLogSettings `locationName:"accessLogSettings" type:"structure"` // Specifies whether a cache cluster is enabled for the stage. CacheClusterEnabled *bool `locationName:"cacheClusterEnabled" type:"boolean"` // The size of the cache cluster for the stage, if enabled. CacheClusterSize CacheClusterSize `locationName:"cacheClusterSize" type:"string" enum:"true"` // The status of the cache cluster for the stage, if enabled. CacheClusterStatus CacheClusterStatus `locationName:"cacheClusterStatus" type:"string" enum:"true"` // Settings for the canary deployment in this stage. CanarySettings *CanarySettings `locationName:"canarySettings" type:"structure"` // The identifier of a client certificate for an API stage. ClientCertificateId *string `locationName:"clientCertificateId" type:"string"` // The timestamp when the stage was created. CreatedDate *time.Time `locationName:"createdDate" type:"timestamp"` // The identifier of the Deployment that the stage points to. DeploymentId *string `locationName:"deploymentId" type:"string"` // The stage's description. Description *string `locationName:"description" type:"string"` // The version of the associated API documentation. DocumentationVersion *string `locationName:"documentationVersion" type:"string"` // The timestamp when the stage last updated. LastUpdatedDate *time.Time `locationName:"lastUpdatedDate" type:"timestamp"` // A map that defines the method settings for a Stage resource. Keys (designated // as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} // for an individual method override, or /\*/\* for overriding all methods in // the stage. MethodSettings map[string]MethodSetting `locationName:"methodSettings" type:"map"` // The name of the stage is the first path segment in the Uniform Resource Identifier // (URI) of a call to API Gateway. Stage names can only contain alphanumeric // characters, hyphens, and underscores. Maximum length is 128 characters. StageName *string `locationName:"stageName" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // Specifies whether active tracing with X-ray is enabled for the Stage. TracingEnabled *bool `locationName:"tracingEnabled" type:"boolean"` // A map that defines the stage variables for a Stage resource. Variable names // can have alphanumeric and underscore characters, and the values must match // [A-Za-z0-9-._~:/?#&=,]+. Variables map[string]string `locationName:"variables" type:"map"` // The ARN of the WebAcl associated with the Stage. WebAclArn *string `locationName:"webAclArn" type:"string"` // contains filtered or unexported fields }
Represents a unique identifier for a version of a deployed RestApi that is callable by users.
Deploy an API (https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-deploy-api.html)
func (UpdateStageOutput) MarshalFields ¶
func (s UpdateStageOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateStageOutput) String ¶
func (s UpdateStageOutput) String() string
String returns the string representation
type UpdateStageRequest ¶
type UpdateStageRequest struct { *aws.Request Input *UpdateStageInput Copy func(*UpdateStageInput) UpdateStageRequest }
UpdateStageRequest is the request type for the UpdateStage API operation.
func (UpdateStageRequest) Send ¶
func (r UpdateStageRequest) Send(ctx context.Context) (*UpdateStageResponse, error)
Send marshals and sends the UpdateStage API request.
type UpdateStageResponse ¶
type UpdateStageResponse struct { *UpdateStageOutput // contains filtered or unexported fields }
UpdateStageResponse is the response type for the UpdateStage API operation.
func (*UpdateStageResponse) SDKResponseMetdata ¶
func (r *UpdateStageResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateStage request.
type UpdateUsageInput ¶
type UpdateUsageInput struct { // [Required] The identifier of the API key associated with the usage plan in // which a temporary extension is granted to the remaining quota. // // KeyId is a required field KeyId *string `location:"uri" locationName:"keyId" type:"string" required:"true"` // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The Id of the usage plan associated with the usage data. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The PATCH request to grant a temporary extension to the remaining quota of a usage plan associated with a specified API key.
func (UpdateUsageInput) MarshalFields ¶
func (s UpdateUsageInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateUsageInput) String ¶
func (s UpdateUsageInput) String() string
String returns the string representation
func (*UpdateUsageInput) Validate ¶
func (s *UpdateUsageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateUsageOutput ¶
type UpdateUsageOutput struct { // The ending date of the usage data. EndDate *string `locationName:"endDate" type:"string"` // The usage data, as daily logs of used and remaining quotas, over the specified // time interval indexed over the API keys in a usage plan. For example, {..., // "values" : { "{api_key}" : [ [0, 100], [10, 90], [100, 10]]}, where {api_key} // stands for an API key value and the daily log entry is of the format [used // quota, remaining quota]. Items map[string][][]int64 `locationName:"values" type:"map"` Position *string `locationName:"position" type:"string"` // The starting date of the usage data. StartDate *string `locationName:"startDate" type:"string"` // The plan Id associated with this usage data. UsagePlanId *string `locationName:"usagePlanId" type:"string"` // contains filtered or unexported fields }
Represents the usage data of a usage plan.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html), Manage Usage in a Usage Plan (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-usage-plans-with-console.html#api-gateway-usage-plan-manage-usage)
func (UpdateUsageOutput) MarshalFields ¶
func (s UpdateUsageOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateUsageOutput) String ¶
func (s UpdateUsageOutput) String() string
String returns the string representation
type UpdateUsagePlanInput ¶
type UpdateUsagePlanInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The Id of the to-be-updated usage plan. // // UsagePlanId is a required field UsagePlanId *string `location:"uri" locationName:"usageplanId" type:"string" required:"true"` // contains filtered or unexported fields }
The PATCH request to update a usage plan of a given plan Id.
func (UpdateUsagePlanInput) MarshalFields ¶
func (s UpdateUsagePlanInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateUsagePlanInput) String ¶
func (s UpdateUsagePlanInput) String() string
String returns the string representation
func (*UpdateUsagePlanInput) Validate ¶
func (s *UpdateUsagePlanInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateUsagePlanOutput ¶
type UpdateUsagePlanOutput struct { // The associated API stages of a usage plan. ApiStages []ApiStage `locationName:"apiStages" type:"list"` // The description of a usage plan. Description *string `locationName:"description" type:"string"` // The identifier of a UsagePlan resource. Id *string `locationName:"id" type:"string"` // The name of a usage plan. Name *string `locationName:"name" type:"string"` // The AWS Markeplace product identifier to associate with the usage plan as // a SaaS product on AWS Marketplace. ProductCode *string `locationName:"productCode" type:"string"` // The maximum number of permitted requests per a given unit time interval. Quota *QuotaSettings `locationName:"quota" type:"structure"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The request throttle limits of a usage plan. Throttle *ThrottleSettings `locationName:"throttle" type:"structure"` // contains filtered or unexported fields }
Represents a usage plan than can specify who can assess associated API stages with specified request limits and quotas.
In a usage plan, you associate an API by specifying the API's Id and a stage name of the specified API. You add plan customers by adding API keys to the plan.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (UpdateUsagePlanOutput) MarshalFields ¶
func (s UpdateUsagePlanOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateUsagePlanOutput) String ¶
func (s UpdateUsagePlanOutput) String() string
String returns the string representation
type UpdateUsagePlanRequest ¶
type UpdateUsagePlanRequest struct { *aws.Request Input *UpdateUsagePlanInput Copy func(*UpdateUsagePlanInput) UpdateUsagePlanRequest }
UpdateUsagePlanRequest is the request type for the UpdateUsagePlan API operation.
func (UpdateUsagePlanRequest) Send ¶
func (r UpdateUsagePlanRequest) Send(ctx context.Context) (*UpdateUsagePlanResponse, error)
Send marshals and sends the UpdateUsagePlan API request.
type UpdateUsagePlanResponse ¶
type UpdateUsagePlanResponse struct { *UpdateUsagePlanOutput // contains filtered or unexported fields }
UpdateUsagePlanResponse is the response type for the UpdateUsagePlan API operation.
func (*UpdateUsagePlanResponse) SDKResponseMetdata ¶
func (r *UpdateUsagePlanResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateUsagePlan request.
type UpdateUsageRequest ¶
type UpdateUsageRequest struct { *aws.Request Input *UpdateUsageInput Copy func(*UpdateUsageInput) UpdateUsageRequest }
UpdateUsageRequest is the request type for the UpdateUsage API operation.
func (UpdateUsageRequest) Send ¶
func (r UpdateUsageRequest) Send(ctx context.Context) (*UpdateUsageResponse, error)
Send marshals and sends the UpdateUsage API request.
type UpdateUsageResponse ¶
type UpdateUsageResponse struct { *UpdateUsageOutput // contains filtered or unexported fields }
UpdateUsageResponse is the response type for the UpdateUsage API operation.
func (*UpdateUsageResponse) SDKResponseMetdata ¶
func (r *UpdateUsageResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateUsage request.
type UpdateVpcLinkInput ¶
type UpdateVpcLinkInput struct { // A list of update operations to be applied to the specified resource and in // the order specified in this list. PatchOperations []PatchOperation `locationName:"patchOperations" type:"list"` // [Required] The identifier of the VpcLink. It is used in an Integration to // reference this VpcLink. // // VpcLinkId is a required field VpcLinkId *string `location:"uri" locationName:"vpclink_id" type:"string" required:"true"` // contains filtered or unexported fields }
Updates an existing VpcLink of a specified identifier.
func (UpdateVpcLinkInput) MarshalFields ¶
func (s UpdateVpcLinkInput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateVpcLinkInput) String ¶
func (s UpdateVpcLinkInput) String() string
String returns the string representation
func (*UpdateVpcLinkInput) Validate ¶
func (s *UpdateVpcLinkInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateVpcLinkOutput ¶
type UpdateVpcLinkOutput struct { // The description of the VPC link. Description *string `locationName:"description" type:"string"` // The identifier of the VpcLink. It is used in an Integration to reference // this VpcLink. Id *string `locationName:"id" type:"string"` // The name used to label and identify the VPC link. Name *string `locationName:"name" type:"string"` // The status of the VPC link. The valid values are AVAILABLE, PENDING, DELETING, // or FAILED. Deploying an API will wait if the status is PENDING and will fail // if the status is DELETING. Status VpcLinkStatus `locationName:"status" type:"string" enum:"true"` // A description about the VPC link status. StatusMessage *string `locationName:"statusMessage" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The ARNs of network load balancers of the VPC targeted by the VPC link. The // network load balancers must be owned by the same AWS account of the API owner. TargetArns []string `locationName:"targetArns" type:"list"` // contains filtered or unexported fields }
A API Gateway VPC link for a RestApi to access resources in an Amazon Virtual Private Cloud (VPC).
To enable access to a resource in an Amazon Virtual Private Cloud through Amazon API Gateway, you, as an API developer, create a VpcLink resource targeted for one or more network load balancers of the VPC and then integrate an API method with a private integration that uses the VpcLink. The private integration has an integration type of HTTP or HTTP_PROXY and has a connection type of VPC_LINK. The integration uses the connectionId property to identify the VpcLink used.
func (UpdateVpcLinkOutput) MarshalFields ¶
func (s UpdateVpcLinkOutput) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UpdateVpcLinkOutput) String ¶
func (s UpdateVpcLinkOutput) String() string
String returns the string representation
type UpdateVpcLinkRequest ¶
type UpdateVpcLinkRequest struct { *aws.Request Input *UpdateVpcLinkInput Copy func(*UpdateVpcLinkInput) UpdateVpcLinkRequest }
UpdateVpcLinkRequest is the request type for the UpdateVpcLink API operation.
func (UpdateVpcLinkRequest) Send ¶
func (r UpdateVpcLinkRequest) Send(ctx context.Context) (*UpdateVpcLinkResponse, error)
Send marshals and sends the UpdateVpcLink API request.
type UpdateVpcLinkResponse ¶
type UpdateVpcLinkResponse struct { *UpdateVpcLinkOutput // contains filtered or unexported fields }
UpdateVpcLinkResponse is the response type for the UpdateVpcLink API operation.
func (*UpdateVpcLinkResponse) SDKResponseMetdata ¶
func (r *UpdateVpcLinkResponse) SDKResponseMetdata() *aws.Response
SDKResponseMetdata returns the response metadata for the UpdateVpcLink request.
type UsagePlan ¶
type UsagePlan struct { // The associated API stages of a usage plan. ApiStages []ApiStage `locationName:"apiStages" type:"list"` // The description of a usage plan. Description *string `locationName:"description" type:"string"` // The identifier of a UsagePlan resource. Id *string `locationName:"id" type:"string"` // The name of a usage plan. Name *string `locationName:"name" type:"string"` // The AWS Markeplace product identifier to associate with the usage plan as // a SaaS product on AWS Marketplace. ProductCode *string `locationName:"productCode" type:"string"` // The maximum number of permitted requests per a given unit time interval. Quota *QuotaSettings `locationName:"quota" type:"structure"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The request throttle limits of a usage plan. Throttle *ThrottleSettings `locationName:"throttle" type:"structure"` // contains filtered or unexported fields }
Represents a usage plan than can specify who can assess associated API stages with specified request limits and quotas.
In a usage plan, you associate an API by specifying the API's Id and a stage name of the specified API. You add plan customers by adding API keys to the plan.
Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (UsagePlan) MarshalFields ¶
func (s UsagePlan) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UsagePlan) String ¶
String returns the string representation
type UsagePlanKey ¶
type UsagePlanKey struct { // The Id of a usage plan key. Id *string `locationName:"id" type:"string"` // The name of a usage plan key. Name *string `locationName:"name" type:"string"` // The type of a usage plan key. Currently, the valid key type is API_KEY. Type *string `locationName:"type" type:"string"` // The value of a usage plan key. Value *string `locationName:"value" type:"string"` // contains filtered or unexported fields }
Represents a usage plan key to identify a plan customer.
To associate an API stage with a selected API key in a usage plan, you must create a UsagePlanKey resource to represent the selected ApiKey.
" Create and Use Usage Plans (https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
func (UsagePlanKey) MarshalFields ¶
func (s UsagePlanKey) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (UsagePlanKey) String ¶
func (s UsagePlanKey) String() string
String returns the string representation
type VpcLink ¶
type VpcLink struct { // The description of the VPC link. Description *string `locationName:"description" type:"string"` // The identifier of the VpcLink. It is used in an Integration to reference // this VpcLink. Id *string `locationName:"id" type:"string"` // The name used to label and identify the VPC link. Name *string `locationName:"name" type:"string"` // The status of the VPC link. The valid values are AVAILABLE, PENDING, DELETING, // or FAILED. Deploying an API will wait if the status is PENDING and will fail // if the status is DELETING. Status VpcLinkStatus `locationName:"status" type:"string" enum:"true"` // A description about the VPC link status. StatusMessage *string `locationName:"statusMessage" type:"string"` // The collection of tags. Each tag element is associated with a given resource. Tags map[string]string `locationName:"tags" type:"map"` // The ARNs of network load balancers of the VPC targeted by the VPC link. The // network load balancers must be owned by the same AWS account of the API owner. TargetArns []string `locationName:"targetArns" type:"list"` // contains filtered or unexported fields }
A API Gateway VPC link for a RestApi to access resources in an Amazon Virtual Private Cloud (VPC).
To enable access to a resource in an Amazon Virtual Private Cloud through Amazon API Gateway, you, as an API developer, create a VpcLink resource targeted for one or more network load balancers of the VPC and then integrate an API method with a private integration that uses the VpcLink. The private integration has an integration type of HTTP or HTTP_PROXY and has a connection type of VPC_LINK. The integration uses the connectionId property to identify the VpcLink used.
func (VpcLink) MarshalFields ¶
func (s VpcLink) MarshalFields(e protocol.FieldEncoder) error
MarshalFields encodes the AWS API shape using the passed in protocol encoder.
func (VpcLink) String ¶
String returns the string representation
type VpcLinkStatus ¶
type VpcLinkStatus string
const ( VpcLinkStatusAvailable VpcLinkStatus = "AVAILABLE" VpcLinkStatusPending VpcLinkStatus = "PENDING" VpcLinkStatusDeleting VpcLinkStatus = "DELETING" VpcLinkStatusFailed VpcLinkStatus = "FAILED" )
Enum values for VpcLinkStatus
func (VpcLinkStatus) MarshalValue ¶
func (enum VpcLinkStatus) MarshalValue() (string, error)
func (VpcLinkStatus) MarshalValueBuf ¶
func (enum VpcLinkStatus) MarshalValueBuf(b []byte) ([]byte, error)
Source Files ¶
api_client.go api_doc.go api_enums.go api_errors.go api_op_CreateApiKey.go api_op_CreateAuthorizer.go api_op_CreateBasePathMapping.go api_op_CreateDeployment.go api_op_CreateDocumentationPart.go api_op_CreateDocumentationVersion.go api_op_CreateDomainName.go api_op_CreateModel.go api_op_CreateRequestValidator.go api_op_CreateResource.go api_op_CreateRestApi.go api_op_CreateStage.go api_op_CreateUsagePlan.go api_op_CreateUsagePlanKey.go api_op_CreateVpcLink.go api_op_DeleteApiKey.go api_op_DeleteAuthorizer.go api_op_DeleteBasePathMapping.go api_op_DeleteClientCertificate.go api_op_DeleteDeployment.go api_op_DeleteDocumentationPart.go api_op_DeleteDocumentationVersion.go api_op_DeleteDomainName.go api_op_DeleteGatewayResponse.go api_op_DeleteIntegration.go api_op_DeleteIntegrationResponse.go api_op_DeleteMethod.go api_op_DeleteMethodResponse.go api_op_DeleteModel.go api_op_DeleteRequestValidator.go api_op_DeleteResource.go api_op_DeleteRestApi.go api_op_DeleteStage.go api_op_DeleteUsagePlan.go api_op_DeleteUsagePlanKey.go api_op_DeleteVpcLink.go api_op_FlushStageAuthorizersCache.go api_op_FlushStageCache.go api_op_GenerateClientCertificate.go api_op_GetAccount.go api_op_GetApiKey.go api_op_GetApiKeys.go api_op_GetAuthorizer.go api_op_GetAuthorizers.go api_op_GetBasePathMapping.go api_op_GetBasePathMappings.go api_op_GetClientCertificate.go api_op_GetClientCertificates.go api_op_GetDeployment.go api_op_GetDeployments.go api_op_GetDocumentationPart.go api_op_GetDocumentationParts.go api_op_GetDocumentationVersion.go api_op_GetDocumentationVersions.go api_op_GetDomainName.go api_op_GetDomainNames.go api_op_GetExport.go api_op_GetGatewayResponse.go api_op_GetGatewayResponses.go api_op_GetIntegration.go api_op_GetIntegrationResponse.go api_op_GetMethod.go api_op_GetMethodResponse.go api_op_GetModel.go api_op_GetModelTemplate.go api_op_GetModels.go api_op_GetRequestValidator.go api_op_GetRequestValidators.go api_op_GetResource.go api_op_GetResources.go api_op_GetRestApi.go api_op_GetRestApis.go api_op_GetSdk.go api_op_GetSdkType.go api_op_GetSdkTypes.go api_op_GetStage.go api_op_GetStages.go api_op_GetTags.go api_op_GetUsage.go api_op_GetUsagePlan.go api_op_GetUsagePlanKey.go api_op_GetUsagePlanKeys.go api_op_GetUsagePlans.go api_op_GetVpcLink.go api_op_GetVpcLinks.go api_op_ImportApiKeys.go api_op_ImportDocumentationParts.go api_op_ImportRestApi.go api_op_PutGatewayResponse.go api_op_PutIntegration.go api_op_PutIntegrationResponse.go api_op_PutMethod.go api_op_PutMethodResponse.go api_op_PutRestApi.go api_op_TagResource.go api_op_TestInvokeAuthorizer.go api_op_TestInvokeMethod.go api_op_UntagResource.go api_op_UpdateAccount.go api_op_UpdateApiKey.go api_op_UpdateAuthorizer.go api_op_UpdateBasePathMapping.go api_op_UpdateClientCertificate.go api_op_UpdateDeployment.go api_op_UpdateDocumentationPart.go api_op_UpdateDocumentationVersion.go api_op_UpdateDomainName.go api_op_UpdateGatewayResponse.go api_op_UpdateIntegration.go api_op_UpdateIntegrationResponse.go api_op_UpdateMethod.go api_op_UpdateMethodResponse.go api_op_UpdateModel.go api_op_UpdateRequestValidator.go api_op_UpdateResource.go api_op_UpdateRestApi.go api_op_UpdateStage.go api_op_UpdateUsage.go api_op_UpdateUsagePlan.go api_op_UpdateVpcLink.go api_types.go customization.go
Directories ¶
Path | Synopsis |
---|---|
service/apigateway/apigatewayiface | Package apigatewayiface provides an interface to enable mocking the Amazon API Gateway service client for testing your code. |
- Version
- v0.19.0
- Published
- Jan 30, 2020
- Platform
- darwin/amd64
- Imports
- 7 packages
- Last checked
- 2 minutes ago –
Tools for package owners.