DocumentDescription
Describes an AWS Systems Manager document (SSM document).
Contents
- ApprovedVersion
-
The version of the document currently approved for use in the organization.
Type: String
Pattern:
([$]LATEST|[$]DEFAULT|^[1-9][0-9]*$)Required: No
- AttachmentsInformation
-
Details about the document attachments, including names, locations, sizes, and so on.
Type: Array of AttachmentInformation objects
Required: No
- Author
-
The user in your organization who created the document.
Type: String
Required: No
- Category
-
The classification of a document to help you identify and categorize its use.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 3 items.
Length Constraints: Maximum length of 128.
Required: No
- CategoryEnum
-
The value that identifies a document's category.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 3 items.
Length Constraints: Maximum length of 128.
Required: No
- CreatedDate
-
The date when the document was created.
Type: Timestamp
Required: No
- DefaultVersion
-
The default version.
Type: String
Pattern:
([$]LATEST|[$]DEFAULT|^[1-9][0-9]*$)Required: No
- Description
-
A description of the document.
Type: String
Required: No
- 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.
Type: String
Length Constraints: Maximum length of 1024.
Pattern:
^[\w\.\-\:\/ ]*$Required: No
- DocumentFormat
-
The document format, either JSON or YAML.
Type: String
Valid Values:
YAML | JSON | TEXTRequired: No
- DocumentType
-
The type of document.
Type: String
Valid Values:
Command | Policy | Automation | Session | Package | ApplicationConfiguration | ApplicationConfigurationSchema | DeploymentStrategy | ChangeCalendar | Automation.ChangeTemplate | ProblemAnalysis | ProblemAnalysisTemplate | CloudFormation | ConformancePackTemplate | QuickSetup | ManualApprovalPolicy | AutoApprovalPolicyRequired: No
- DocumentVersion
-
The document version.
Type: String
Pattern:
([$]LATEST|[$]DEFAULT|^[1-9][0-9]*$)Required: No
- Hash
-
The Sha256 or Sha1 hash created by the system when the document was created.
Note
Sha1 hashes have been deprecated.
Type: String
Length Constraints: Maximum length of 256.
Required: No
- HashType
-
The hash type of the document. Valid values include
Sha256orSha1.Note
Sha1 hashes have been deprecated.
Type: String
Valid Values:
Sha256 | Sha1Required: No
- LatestVersion
-
The latest version of the document.
Type: String
Pattern:
([$]LATEST|[$]DEFAULT|^[1-9][0-9]*$)Required: No
- Name
-
The name of the SSM document.
Type: String
Pattern:
^[a-zA-Z0-9_\-.:/]{3,128}$Required: No
- Owner
-
The Amazon Web Services user that created the document.
Type: String
Required: No
- Parameters
-
A description of the parameters for a document.
Type: Array of DocumentParameter objects
Required: No
- PendingReviewVersion
-
The version of the document that is currently under review.
Type: String
Pattern:
([$]LATEST|[$]DEFAULT|^[1-9][0-9]*$)Required: No
- PlatformTypes
-
The list of operating system (OS) platforms compatible with this SSM document.
Type: Array of strings
Valid Values:
Windows | Linux | MacOSRequired: No
- Requires
-
A list of SSM documents required by a document. For example, an
ApplicationConfigurationdocument requires anApplicationConfigurationSchemadocument.Type: Array of DocumentRequires objects
Array Members: Minimum number of 1 item.
Required: No
- ReviewInformation
-
Details about the review of a document.
Type: Array of ReviewInformation objects
Array Members: Minimum number of 1 item.
Required: No
- ReviewStatus
-
The current status of the review.
Type: String
Valid Values:
APPROVED | NOT_REVIEWED | PENDING | REJECTEDRequired: No
- SchemaVersion
-
The schema version.
Type: String
Pattern:
([0-9]+)\.([0-9]+)Required: No
- Sha1
-
The SHA1 hash of the document, which you can use for verification.
Type: String
Required: No
- Status
-
The status of the SSM document.
Type: String
Valid Values:
Creating | Active | Updating | Deleting | FailedRequired: No
- StatusInformation
-
A message returned by AWS Systems Manager that explains the
Statusvalue. For example, aFailedstatus might be explained by theStatusInformationmessage, "The specified S3 bucket doesn't exist. Verify that the URL of the S3 bucket is correct."Type: String
Required: No
- Tags
-
The tags, or metadata, that have been applied to the document.
Type: Array of Tag objects
Array Members: Maximum number of 1000 items.
Required: No
- TargetType
-
The target type which defines the kinds of resources the document can run on. For example,
/AWS::EC2::Instance. For a list of valid resource types, see AWS resource and property types reference in the AWS CloudFormation User Guide.Type: String
Length Constraints: Maximum length of 200.
Pattern:
^\/[\w\.\-\:\/]*$Required: No
- VersionName
-
The version of the artifact associated with the document.
Type: String
Pattern:
^[a-zA-Z0-9_\-.]{1,128}$Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: