Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Update a component.
There are a few modes for updating a component. The deploymentType
field defines the mode.
You can't update a component while its deployment status, or the
deployment status of a service instance attached to it, is
IN_PROGRESS
.
For more information about components, see Proton components in the Proton User Guide.
Synopsis
- data UpdateComponent = UpdateComponent' {}
- newUpdateComponent :: ComponentDeploymentUpdateType -> Text -> UpdateComponent
- updateComponent_description :: Lens' UpdateComponent (Maybe Text)
- updateComponent_serviceInstanceName :: Lens' UpdateComponent (Maybe Text)
- updateComponent_serviceName :: Lens' UpdateComponent (Maybe Text)
- updateComponent_serviceSpec :: Lens' UpdateComponent (Maybe Text)
- updateComponent_templateFile :: Lens' UpdateComponent (Maybe Text)
- updateComponent_deploymentType :: Lens' UpdateComponent ComponentDeploymentUpdateType
- updateComponent_name :: Lens' UpdateComponent Text
- data UpdateComponentResponse = UpdateComponentResponse' {
- httpStatus :: Int
- component :: Component
- newUpdateComponentResponse :: Int -> Component -> UpdateComponentResponse
- updateComponentResponse_httpStatus :: Lens' UpdateComponentResponse Int
- updateComponentResponse_component :: Lens' UpdateComponentResponse Component
Creating a Request
data UpdateComponent Source #
See: newUpdateComponent
smart constructor.
UpdateComponent' | |
|
Instances
Create a value of UpdateComponent
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
UpdateComponent
, updateComponent_description
- An optional customer-provided description of the component.
UpdateComponent
, updateComponent_serviceInstanceName
- The name of the service instance that you want to attach this component
to. Don't specify to keep the component's current service instance
attachment. Specify an empty string to detach the component from the
service instance it's attached to. Specify non-empty values for both
serviceInstanceName
and serviceName
or for neither of them.
UpdateComponent
, updateComponent_serviceName
- The name of the service that serviceInstanceName
is associated with.
Don't specify to keep the component's current service instance
attachment. Specify an empty string to detach the component from the
service instance it's attached to. Specify non-empty values for both
serviceInstanceName
and serviceName
or for neither of them.
UpdateComponent
, updateComponent_serviceSpec
- The service spec that you want the component to use to access service
inputs. Set this only when the component is attached to a service
instance.
$sel:templateFile:UpdateComponent'
, updateComponent_templateFile
- A path to the Infrastructure as Code (IaC) file describing
infrastructure that a custom component provisions.
Components support a single IaC file, even if you use Terraform as your template language.
$sel:deploymentType:UpdateComponent'
, updateComponent_deploymentType
- The deployment type. It defines the mode for updating a component, as
follows:
[]
NONE
In this mode, a deployment doesn't occur. Only the requested
metadata parameters are updated. You can only specify description
in this mode.
[]
CURRENT_VERSION
In this mode, the component is deployed and updated with the new
serviceSpec
, templateSource
, and/or type
that you provide.
Only requested parameters are updated.
UpdateComponent
, updateComponent_name
- The name of the component to update.
Request Lenses
updateComponent_description :: Lens' UpdateComponent (Maybe Text) Source #
An optional customer-provided description of the component.
updateComponent_serviceInstanceName :: Lens' UpdateComponent (Maybe Text) Source #
The name of the service instance that you want to attach this component
to. Don't specify to keep the component's current service instance
attachment. Specify an empty string to detach the component from the
service instance it's attached to. Specify non-empty values for both
serviceInstanceName
and serviceName
or for neither of them.
updateComponent_serviceName :: Lens' UpdateComponent (Maybe Text) Source #
The name of the service that serviceInstanceName
is associated with.
Don't specify to keep the component's current service instance
attachment. Specify an empty string to detach the component from the
service instance it's attached to. Specify non-empty values for both
serviceInstanceName
and serviceName
or for neither of them.
updateComponent_serviceSpec :: Lens' UpdateComponent (Maybe Text) Source #
The service spec that you want the component to use to access service inputs. Set this only when the component is attached to a service instance.
updateComponent_templateFile :: Lens' UpdateComponent (Maybe Text) Source #
A path to the Infrastructure as Code (IaC) file describing infrastructure that a custom component provisions.
Components support a single IaC file, even if you use Terraform as your template language.
updateComponent_deploymentType :: Lens' UpdateComponent ComponentDeploymentUpdateType Source #
The deployment type. It defines the mode for updating a component, as follows:
[]
NONE
In this mode, a deployment doesn't occur. Only the requested
metadata parameters are updated. You can only specify description
in this mode.
[]
CURRENT_VERSION
In this mode, the component is deployed and updated with the new
serviceSpec
, templateSource
, and/or type
that you provide.
Only requested parameters are updated.
updateComponent_name :: Lens' UpdateComponent Text Source #
The name of the component to update.
Destructuring the Response
data UpdateComponentResponse Source #
See: newUpdateComponentResponse
smart constructor.
UpdateComponentResponse' | |
|
Instances
newUpdateComponentResponse Source #
:: Int | |
-> Component | |
-> UpdateComponentResponse |
Create a value of UpdateComponentResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:httpStatus:UpdateComponentResponse'
, updateComponentResponse_httpStatus
- The response's http status code.
$sel:component:UpdateComponentResponse'
, updateComponentResponse_component
- The detailed data of the updated component.
Response Lenses
updateComponentResponse_httpStatus :: Lens' UpdateComponentResponse Int Source #
The response's http status code.
updateComponentResponse_component :: Lens' UpdateComponentResponse Component Source #
The detailed data of the updated component.