amazonka-ssm-2.0: Amazon Simple Systems Manager (SSM) SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.SSM.DeleteAssociation

Description

Disassociates the specified Amazon Web Services Systems Manager document (SSM document) from the specified managed node. If you created the association by using the Targets parameter, then you must delete the association by using the association ID.

When you disassociate a document from a managed node, it doesn't change the configuration of the node. To change the configuration state of a managed node after you disassociate a document, you must create a new document with the desired configuration and associate it with the node.

Synopsis

Creating a Request

data DeleteAssociation Source #

See: newDeleteAssociation smart constructor.

Constructors

DeleteAssociation' 

Fields

  • associationId :: Maybe Text

    The association ID that you want to delete.

  • instanceId :: Maybe Text

    The managed node ID.

    InstanceId has been deprecated. To specify a managed node ID for an association, use the Targets parameter. Requests that include the parameter InstanceID with Systems Manager documents (SSM documents) that use schema version 2.0 or later will fail. In addition, if you use the parameter InstanceId, you can't use the parameters AssociationName, DocumentVersion, MaxErrors, MaxConcurrency, OutputLocation, or ScheduleExpression. To use these parameters, you must use the Targets parameter.

  • name :: Maybe Text

    The name of the SSM document.

Instances

Instances details
ToJSON DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

ToHeaders DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

ToPath DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

ToQuery DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

AWSRequest DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Associated Types

type AWSResponse DeleteAssociation #

Generic DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Associated Types

type Rep DeleteAssociation :: Type -> Type #

Read DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Show DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

NFData DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Methods

rnf :: DeleteAssociation -> () #

Eq DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Hashable DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

type AWSResponse DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

type Rep DeleteAssociation Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

type Rep DeleteAssociation = D1 ('MetaData "DeleteAssociation" "Amazonka.SSM.DeleteAssociation" "amazonka-ssm-2.0-Ak65QSGRhJDC5x7UvsCpi8" 'False) (C1 ('MetaCons "DeleteAssociation'" 'PrefixI 'True) (S1 ('MetaSel ('Just "associationId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "instanceId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))

newDeleteAssociation :: DeleteAssociation Source #

Create a value of DeleteAssociation 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:

DeleteAssociation, deleteAssociation_associationId - The association ID that you want to delete.

DeleteAssociation, deleteAssociation_instanceId - The managed node ID.

InstanceId has been deprecated. To specify a managed node ID for an association, use the Targets parameter. Requests that include the parameter InstanceID with Systems Manager documents (SSM documents) that use schema version 2.0 or later will fail. In addition, if you use the parameter InstanceId, you can't use the parameters AssociationName, DocumentVersion, MaxErrors, MaxConcurrency, OutputLocation, or ScheduleExpression. To use these parameters, you must use the Targets parameter.

DeleteAssociation, deleteAssociation_name - The name of the SSM document.

Request Lenses

deleteAssociation_associationId :: Lens' DeleteAssociation (Maybe Text) Source #

The association ID that you want to delete.

deleteAssociation_instanceId :: Lens' DeleteAssociation (Maybe Text) Source #

The managed node ID.

InstanceId has been deprecated. To specify a managed node ID for an association, use the Targets parameter. Requests that include the parameter InstanceID with Systems Manager documents (SSM documents) that use schema version 2.0 or later will fail. In addition, if you use the parameter InstanceId, you can't use the parameters AssociationName, DocumentVersion, MaxErrors, MaxConcurrency, OutputLocation, or ScheduleExpression. To use these parameters, you must use the Targets parameter.

deleteAssociation_name :: Lens' DeleteAssociation (Maybe Text) Source #

The name of the SSM document.

Destructuring the Response

data DeleteAssociationResponse Source #

See: newDeleteAssociationResponse smart constructor.

Constructors

DeleteAssociationResponse' 

Fields

Instances

Instances details
Generic DeleteAssociationResponse Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Associated Types

type Rep DeleteAssociationResponse :: Type -> Type #

Read DeleteAssociationResponse Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Show DeleteAssociationResponse Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

NFData DeleteAssociationResponse Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

Eq DeleteAssociationResponse Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

type Rep DeleteAssociationResponse Source # 
Instance details

Defined in Amazonka.SSM.DeleteAssociation

type Rep DeleteAssociationResponse = D1 ('MetaData "DeleteAssociationResponse" "Amazonka.SSM.DeleteAssociation" "amazonka-ssm-2.0-Ak65QSGRhJDC5x7UvsCpi8" 'False) (C1 ('MetaCons "DeleteAssociationResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newDeleteAssociationResponse Source #

Create a value of DeleteAssociationResponse 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:DeleteAssociationResponse', deleteAssociationResponse_httpStatus - The response's http status code.

Response Lenses