libZSservicesZSamazonka-ssmZSamazonka-ssm
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.SSM.GetDocument

Description

Gets the contents of the specified Amazon Web Services Systems Manager document (SSM document).

Synopsis

Creating a Request

data GetDocument Source #

See: newGetDocument smart constructor.

Constructors

GetDocument' 

Fields

  • versionName :: Maybe Text

    An optional field specifying the version of the artifact associated with the document. For example, "Release 12, Update 6". This value is unique across all versions of a document and can't be changed.

  • documentFormat :: Maybe DocumentFormat

    Returns the document in the specified format. The document format can be either JSON or YAML. JSON is the default format.

  • documentVersion :: Maybe Text

    The document version for which you want information.

  • name :: Text

    The name of the SSM document.

Instances

Instances details
Eq GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Read GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Show GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Generic GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Associated Types

type Rep GetDocument :: Type -> Type #

NFData GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Methods

rnf :: GetDocument -> () #

Hashable GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

ToJSON GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

AWSRequest GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Associated Types

type AWSResponse GetDocument #

ToHeaders GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Methods

toHeaders :: GetDocument -> [Header] #

ToPath GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

ToQuery GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

type Rep GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

type Rep GetDocument = D1 ('MetaData "GetDocument" "Amazonka.SSM.GetDocument" "libZSservicesZSamazonka-ssmZSamazonka-ssm" 'False) (C1 ('MetaCons "GetDocument'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "versionName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "documentFormat") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DocumentFormat))) :*: (S1 ('MetaSel ('Just "documentVersion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))
type AWSResponse GetDocument Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

newGetDocument Source #

Create a value of GetDocument 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:versionName:GetDocument', getDocument_versionName - An optional field specifying the version of the artifact associated with the document. For example, "Release 12, Update 6". This value is unique across all versions of a document and can't be changed.

$sel:documentFormat:GetDocument', getDocument_documentFormat - Returns the document in the specified format. The document format can be either JSON or YAML. JSON is the default format.

$sel:documentVersion:GetDocument', getDocument_documentVersion - The document version for which you want information.

$sel:name:GetDocument', getDocument_name - The name of the SSM document.

Request Lenses

getDocument_versionName :: Lens' GetDocument (Maybe Text) Source #

An optional field specifying the version of the artifact associated with the document. For example, "Release 12, Update 6". This value is unique across all versions of a document and can't be changed.

getDocument_documentFormat :: Lens' GetDocument (Maybe DocumentFormat) Source #

Returns the document in the specified format. The document format can be either JSON or YAML. JSON is the default format.

getDocument_documentVersion :: Lens' GetDocument (Maybe Text) Source #

The document version for which you want information.

getDocument_name :: Lens' GetDocument Text Source #

The name of the SSM document.

Destructuring the Response

data GetDocumentResponse Source #

See: newGetDocumentResponse smart constructor.

Constructors

GetDocumentResponse' 

Fields

  • status :: Maybe DocumentStatus

    The status of the SSM document, such as Creating, Active, Updating, Failed, and Deleting.

  • documentType :: Maybe DocumentType

    The document type.

  • versionName :: Maybe Text

    The version of the artifact associated with the document. For example, "Release 12, Update 6". This value is unique across all versions of a document, and can't be changed.

  • attachmentsContent :: Maybe [AttachmentContent]

    A description of the document attachments, including names, locations, sizes, and so on.

  • reviewStatus :: Maybe ReviewStatus

    The current review status of a new custom Systems Manager document (SSM document) created by a member of your organization, or of the latest version of an existing SSM document.

    Only one version of an SSM document can be in the APPROVED state at a time. When a new version is approved, the status of the previous version changes to REJECTED.

    Only one version of an SSM document can be in review, or PENDING, at a time.

  • content :: Maybe Text

    The contents of the SSM document.

  • createdDate :: Maybe POSIX

    The date the SSM document was created.

  • documentFormat :: Maybe DocumentFormat

    The document format, either JSON or YAML.

  • name :: Maybe Text

    The name of the SSM document.

  • documentVersion :: Maybe Text

    The document version.

  • displayName :: Maybe Text

    The friendly name of the SSM document. This value can differ for each version of the document. If you want to update this value, see UpdateDocument.

  • statusInformation :: Maybe Text

    A message returned by Amazon Web Services Systems Manager that explains the Status value. For example, a Failed status might be explained by the StatusInformation message, "The specified S3 bucket doesn't exist. Verify that the URL of the S3 bucket is correct."

  • requires :: Maybe (NonEmpty DocumentRequires)

    A list of SSM documents required by a document. For example, an ApplicationConfiguration document requires an ApplicationConfigurationSchema document.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Eq GetDocumentResponse Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Read GetDocumentResponse Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Show GetDocumentResponse Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Generic GetDocumentResponse Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Associated Types

type Rep GetDocumentResponse :: Type -> Type #

NFData GetDocumentResponse Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

Methods

rnf :: GetDocumentResponse -> () #

type Rep GetDocumentResponse Source # 
Instance details

Defined in Amazonka.SSM.GetDocument

type Rep GetDocumentResponse = D1 ('MetaData "GetDocumentResponse" "Amazonka.SSM.GetDocument" "libZSservicesZSamazonka-ssmZSamazonka-ssm" 'False) (C1 ('MetaCons "GetDocumentResponse'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DocumentStatus)) :*: (S1 ('MetaSel ('Just "documentType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DocumentType)) :*: S1 ('MetaSel ('Just "versionName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "attachmentsContent") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [AttachmentContent])) :*: S1 ('MetaSel ('Just "reviewStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ReviewStatus))) :*: (S1 ('MetaSel ('Just "content") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "createdDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX))))) :*: ((S1 ('MetaSel ('Just "documentFormat") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DocumentFormat)) :*: (S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "documentVersion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "displayName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "statusInformation") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "requires") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (NonEmpty DocumentRequires))) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))))

newGetDocumentResponse Source #

Create a value of GetDocumentResponse 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:status:GetDocumentResponse', getDocumentResponse_status - The status of the SSM document, such as Creating, Active, Updating, Failed, and Deleting.

$sel:documentType:GetDocumentResponse', getDocumentResponse_documentType - The document type.

$sel:versionName:GetDocument', getDocumentResponse_versionName - The version of the artifact associated with the document. For example, "Release 12, Update 6". This value is unique across all versions of a document, and can't be changed.

$sel:attachmentsContent:GetDocumentResponse', getDocumentResponse_attachmentsContent - A description of the document attachments, including names, locations, sizes, and so on.

$sel:reviewStatus:GetDocumentResponse', getDocumentResponse_reviewStatus - The current review status of a new custom Systems Manager document (SSM document) created by a member of your organization, or of the latest version of an existing SSM document.

Only one version of an SSM document can be in the APPROVED state at a time. When a new version is approved, the status of the previous version changes to REJECTED.

Only one version of an SSM document can be in review, or PENDING, at a time.

$sel:content:GetDocumentResponse', getDocumentResponse_content - The contents of the SSM document.

$sel:createdDate:GetDocumentResponse', getDocumentResponse_createdDate - The date the SSM document was created.

$sel:documentFormat:GetDocument', getDocumentResponse_documentFormat - The document format, either JSON or YAML.

$sel:name:GetDocument', getDocumentResponse_name - The name of the SSM document.

$sel:documentVersion:GetDocument', getDocumentResponse_documentVersion - The document version.

$sel:displayName:GetDocumentResponse', getDocumentResponse_displayName - The friendly name of the SSM document. This value can differ for each version of the document. If you want to update this value, see UpdateDocument.

$sel:statusInformation:GetDocumentResponse', getDocumentResponse_statusInformation - A message returned by Amazon Web Services Systems Manager that explains the Status value. For example, a Failed status might be explained by the StatusInformation message, "The specified S3 bucket doesn't exist. Verify that the URL of the S3 bucket is correct."

$sel:requires:GetDocumentResponse', getDocumentResponse_requires - A list of SSM documents required by a document. For example, an ApplicationConfiguration document requires an ApplicationConfigurationSchema document.

$sel:httpStatus:GetDocumentResponse', getDocumentResponse_httpStatus - The response's http status code.

Response Lenses

getDocumentResponse_status :: Lens' GetDocumentResponse (Maybe DocumentStatus) Source #

The status of the SSM document, such as Creating, Active, Updating, Failed, and Deleting.

getDocumentResponse_versionName :: Lens' GetDocumentResponse (Maybe Text) Source #

The version of the artifact associated with the document. For example, "Release 12, Update 6". This value is unique across all versions of a document, and can't be changed.

getDocumentResponse_attachmentsContent :: Lens' GetDocumentResponse (Maybe [AttachmentContent]) Source #

A description of the document attachments, including names, locations, sizes, and so on.

getDocumentResponse_reviewStatus :: Lens' GetDocumentResponse (Maybe ReviewStatus) Source #

The current review status of a new custom Systems Manager document (SSM document) created by a member of your organization, or of the latest version of an existing SSM document.

Only one version of an SSM document can be in the APPROVED state at a time. When a new version is approved, the status of the previous version changes to REJECTED.

Only one version of an SSM document can be in review, or PENDING, at a time.

getDocumentResponse_displayName :: Lens' GetDocumentResponse (Maybe Text) Source #

The friendly name of the SSM document. This value can differ for each version of the document. If you want to update this value, see UpdateDocument.

getDocumentResponse_statusInformation :: Lens' GetDocumentResponse (Maybe Text) Source #

A message returned by Amazon Web Services Systems Manager that explains the Status value. For example, a Failed status might be explained by the StatusInformation message, "The specified S3 bucket doesn't exist. Verify that the URL of the S3 bucket is correct."

getDocumentResponse_requires :: Lens' GetDocumentResponse (Maybe (NonEmpty DocumentRequires)) Source #

A list of SSM documents required by a document. For example, an ApplicationConfiguration document requires an ApplicationConfigurationSchema document.