Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.CloudHSM.DescribeHsm

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Retrieves information about an HSM. You can identify the HSM by its ARN or its serial number.

Synopsis

data DescribeHsm = DescribeHsm' {
- hsmSerialNumber :: Maybe Text
- hsmArn :: Maybe Text
}
newDescribeHsm :: DescribeHsm
describeHsm_hsmSerialNumber :: Lens' DescribeHsm (Maybe Text)
describeHsm_hsmArn :: Lens' DescribeHsm (Maybe Text)
data DescribeHsmResponse = DescribeHsmResponse' {
- status :: Maybe HsmStatus
- iamRoleArn :: Maybe Text
- eniId :: Maybe Text
- vpcId :: Maybe Text
- sshKeyLastUpdated :: Maybe Text
- subscriptionEndDate :: Maybe Text
- serverCertUri :: Maybe Text
- subscriptionType :: Maybe SubscriptionType
- sshPublicKey :: Maybe Text
- subnetId :: Maybe Text
- statusDetails :: Maybe Text
- partitions :: Maybe [Text]
- subscriptionStartDate :: Maybe Text
- availabilityZone :: Maybe Text
- serverCertLastUpdated :: Maybe Text
- softwareVersion :: Maybe Text
- vendorName :: Maybe Text
- serialNumber :: Maybe Text
- hsmArn :: Maybe Text
- eniIp :: Maybe Text
- hsmType :: Maybe Text
- httpStatus :: Int
}
newDescribeHsmResponse :: Int -> DescribeHsmResponse
describeHsmResponse_status :: Lens' DescribeHsmResponse (Maybe HsmStatus)
describeHsmResponse_iamRoleArn :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_eniId :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_vpcId :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_sshKeyLastUpdated :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_subscriptionEndDate :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_serverCertUri :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_subscriptionType :: Lens' DescribeHsmResponse (Maybe SubscriptionType)
describeHsmResponse_sshPublicKey :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_subnetId :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_statusDetails :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_partitions :: Lens' DescribeHsmResponse (Maybe [Text])
describeHsmResponse_subscriptionStartDate :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_availabilityZone :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_serverCertLastUpdated :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_softwareVersion :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_vendorName :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_serialNumber :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_hsmArn :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_eniIp :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_hsmType :: Lens' DescribeHsmResponse (Maybe Text)
describeHsmResponse_httpStatus :: Lens' DescribeHsmResponse Int

Creating a Request

data DescribeHsm Source #

Contains the inputs for the DescribeHsm operation.

See: newDescribeHsm smart constructor.

Constructors

DescribeHsm'
Fields hsmSerialNumber :: Maybe Text The serial number of the HSM. Either the `HsmArn` or the `HsmSerialNumber` parameter must be specified. hsmArn :: Maybe Text The ARN of the HSM. Either the `HsmArn` or the `SerialNumber` parameter must be specified.

Instances

Instances details

Eq DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods (==) :: DescribeHsm -> DescribeHsm -> Bool # (/=) :: DescribeHsm -> DescribeHsm -> Bool #
Read DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods readsPrec :: Int -> ReadS DescribeHsm # readList :: ReadS [DescribeHsm] # readPrec :: ReadPrec DescribeHsm # readListPrec :: ReadPrec [DescribeHsm] #
Show DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods showsPrec :: Int -> DescribeHsm -> ShowS # show :: DescribeHsm -> String # showList :: [DescribeHsm] -> ShowS #
Generic DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Associated Types type Rep DescribeHsm :: Type -> Type # Methods from :: DescribeHsm -> Rep DescribeHsm x # to :: Rep DescribeHsm x -> DescribeHsm #
NFData DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods rnf :: DescribeHsm -> () #
Hashable DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods hashWithSalt :: Int -> DescribeHsm -> Int # hash :: DescribeHsm -> Int #
ToJSON DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods toJSON :: DescribeHsm -> Value # toEncoding :: DescribeHsm -> Encoding # toJSONList :: [DescribeHsm] -> Value # toEncodingList :: [DescribeHsm] -> Encoding #
AWSRequest DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Associated Types type AWSResponse DescribeHsm # Methods request :: DescribeHsm -> Request DescribeHsm # response :: MonadResource m => Logger -> Service -> Proxy DescribeHsm -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeHsm))) #
ToHeaders DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods toHeaders :: DescribeHsm -> [Header] #
ToPath DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods toPath :: DescribeHsm -> ByteString #
ToQuery DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods toQuery :: DescribeHsm -> QueryString #
type Rep DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm type Rep DescribeHsm = D1 ('MetaData "DescribeHsm" "Amazonka.CloudHSM.DescribeHsm" "libZSservicesZSamazonka-cloudhsmZSamazonka-cloudhsm" 'False) (C1 ('MetaCons "DescribeHsm'" 'PrefixI 'True) (S1 ('MetaSel ('Just "hsmSerialNumber") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "hsmArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))
type AWSResponse DescribeHsm Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm type AWSResponse DescribeHsm = DescribeHsmResponse

newDescribeHsm :: DescribeHsm Source #

Create a value of DescribeHsm 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:hsmSerialNumber:DescribeHsm', describeHsm_hsmSerialNumber - The serial number of the HSM. Either the HsmArn or the HsmSerialNumber parameter must be specified.

$sel:hsmArn:DescribeHsm', describeHsm_hsmArn - The ARN of the HSM. Either the HsmArn or the SerialNumber parameter must be specified.

Request Lenses

describeHsm_hsmSerialNumber :: Lens' DescribeHsm (Maybe Text) Source #

The serial number of the HSM. Either the HsmArn or the HsmSerialNumber parameter must be specified.

describeHsm_hsmArn :: Lens' DescribeHsm (Maybe Text) Source #

The ARN of the HSM. Either the HsmArn or the SerialNumber parameter must be specified.

Destructuring the Response

data DescribeHsmResponse Source #

Contains the output of the DescribeHsm operation.

See: newDescribeHsmResponse smart constructor.

Constructors

DescribeHsmResponse'

Fields

status :: Maybe HsmStatus
The status of the HSM.
iamRoleArn :: Maybe Text
The ARN of the IAM role assigned to the HSM.
eniId :: Maybe Text
The identifier of the elastic network interface (ENI) attached to the HSM.
vpcId :: Maybe Text
The identifier of the VPC that the HSM is in.
sshKeyLastUpdated :: Maybe Text
The date and time that the SSH key was last updated.
subscriptionEndDate :: Maybe Text
The subscription end date.
serverCertUri :: Maybe Text
The URI of the certificate server.
subscriptionType :: Maybe SubscriptionType
sshPublicKey :: Maybe Text
The public SSH key.
subnetId :: Maybe Text
The identifier of the subnet that the HSM is in.
statusDetails :: Maybe Text
Contains additional information about the status of the HSM.
partitions :: Maybe [Text]
The list of partitions on the HSM.
subscriptionStartDate :: Maybe Text
The subscription start date.
availabilityZone :: Maybe Text
The Availability Zone that the HSM is in.
serverCertLastUpdated :: Maybe Text
The date and time that the server certificate was last updated.
softwareVersion :: Maybe Text
The HSM software version.
vendorName :: Maybe Text
The name of the HSM vendor.
serialNumber :: Maybe Text
The serial number of the HSM.
hsmArn :: Maybe Text
The ARN of the HSM.
eniIp :: Maybe Text
The IP address assigned to the HSM's ENI.
hsmType :: Maybe Text
The HSM model type.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Eq DescribeHsmResponse Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods (==) :: DescribeHsmResponse -> DescribeHsmResponse -> Bool # (/=) :: DescribeHsmResponse -> DescribeHsmResponse -> Bool #
Read DescribeHsmResponse Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods readsPrec :: Int -> ReadS DescribeHsmResponse # readList :: ReadS [DescribeHsmResponse] # readPrec :: ReadPrec DescribeHsmResponse # readListPrec :: ReadPrec [DescribeHsmResponse] #
Show DescribeHsmResponse Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods showsPrec :: Int -> DescribeHsmResponse -> ShowS # show :: DescribeHsmResponse -> String # showList :: [DescribeHsmResponse] -> ShowS #
Generic DescribeHsmResponse Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Associated Types type Rep DescribeHsmResponse :: Type -> Type # Methods from :: DescribeHsmResponse -> Rep DescribeHsmResponse x # to :: Rep DescribeHsmResponse x -> DescribeHsmResponse #
NFData DescribeHsmResponse Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm Methods rnf :: DescribeHsmResponse -> () #
type Rep DescribeHsmResponse Source #
Instance details Defined in Amazonka.CloudHSM.DescribeHsm type Rep DescribeHsmResponse = D1 ('MetaData "DescribeHsmResponse" "Amazonka.CloudHSM.DescribeHsm" "libZSservicesZSamazonka-cloudhsmZSamazonka-cloudhsm" 'False) (C1 ('MetaCons "DescribeHsmResponse'" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe HsmStatus)) :: S1 ('MetaSel ('Just "iamRoleArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "eniId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "vpcId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "sshKeyLastUpdated") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))) :: ((S1 ('MetaSel ('Just "subscriptionEndDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "serverCertUri") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "subscriptionType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SubscriptionType)))) :: (S1 ('MetaSel ('Just "sshPublicKey") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "subnetId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "statusDetails") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))) :: (((S1 ('MetaSel ('Just "partitions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :: S1 ('MetaSel ('Just "subscriptionStartDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "availabilityZone") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "serverCertLastUpdated") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "softwareVersion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))) :: ((S1 ('MetaSel ('Just "vendorName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "serialNumber") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "hsmArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :: (S1 ('MetaSel ('Just "eniIp") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "hsmType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))))