AWS Amplify

2024/02/19 - AWS Amplify - 5 updated api methods

Changes  This release contains API changes that enable users to configure their Amplify domains with their own custom SSL/TLS certificate.

CreateDomainAssociation (updated) Link ¶
Changes (request, response)
Request
{'certificateSettings': {'customCertificateArn': 'string',
                         'type': 'AMPLIFY_MANAGED | CUSTOM'}}
Response
{'domainAssociation': {'certificate': {'certificateVerificationDNSRecord': 'string',
                                       'customCertificateArn': 'string',
                                       'type': 'AMPLIFY_MANAGED | CUSTOM'},
                       'domainStatus': {'AWAITING_APP_CNAME',
                                        'IMPORTING_CUSTOM_CERTIFICATE'},
                       'updateStatus': 'REQUESTING_CERTIFICATE | '
                                       'PENDING_VERIFICATION | '
                                       'IMPORTING_CUSTOM_CERTIFICATE | '
                                       'PENDING_DEPLOYMENT | '
                                       'AWAITING_APP_CNAME | UPDATE_COMPLETE | '
                                       'UPDATE_FAILED'}}

Creates a new domain association for an Amplify app. This action associates a custom domain with the Amplify app

See also: AWS API Documentation

Request Syntax

client.create_domain_association(
    appId='string',
    domainName='string',
    enableAutoSubDomain=True|False,
    subDomainSettings=[
        {
            'prefix': 'string',
            'branchName': 'string'
        },
    ],
    autoSubDomainCreationPatterns=[
        'string',
    ],
    autoSubDomainIAMRole='string',
    certificateSettings={
        'type': 'AMPLIFY_MANAGED'|'CUSTOM',
        'customCertificateArn': 'string'
    }
)
type appId

string

param appId

[REQUIRED]

The unique ID for an Amplify app.

type domainName

string

param domainName

[REQUIRED]

The domain name for the domain association.

type enableAutoSubDomain

boolean

param enableAutoSubDomain

Enables the automated creation of subdomains for branches.

type subDomainSettings

list

param subDomainSettings

[REQUIRED]

The setting for the subdomain.

  • (dict) --

    Describes the settings for the subdomain.

    • prefix (string) -- [REQUIRED]

      The prefix setting for the subdomain.

    • branchName (string) -- [REQUIRED]

      The branch name setting for the subdomain.

type autoSubDomainCreationPatterns

list

param autoSubDomainCreationPatterns

Sets the branch patterns for automatic subdomain creation.

  • (string) --

type autoSubDomainIAMRole

string

param autoSubDomainIAMRole

The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

type certificateSettings

dict

param certificateSettings

The type of SSL/TLS certificate to use for your custom domain. If you don't specify a certificate type, Amplify uses the default certificate that it provisions and manages for you.

  • type (string) -- [REQUIRED]

    The certificate type.

    Specify AMPLIFY_MANAGED to use the default certificate that Amplify provisions for you.

    Specify CUSTOM to use your own certificate that you have already added to Certificate Manager in your Amazon Web Services account. Make sure you request (or import) the certificate in the US East (N. Virginia) Region (us-east-1). For more information about using ACM, see Importing certificates into Certificate Manager in the ACM User guide .

  • customCertificateArn (string) --

    The Amazon resource name (ARN) for the custom certificate that you have already added to Certificate Manager in your Amazon Web Services account.

    This field is required only when the certificate type is CUSTOM .

rtype

dict

returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'updateStatus': 'REQUESTING_CERTIFICATE'|'PENDING_VERIFICATION'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'UPDATE_COMPLETE'|'UPDATE_FAILED',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ],
        'certificate': {
            'type': 'AMPLIFY_MANAGED'|'CUSTOM',
            'customCertificateArn': 'string',
            'certificateVerificationDNSRecord': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The result structure for the create domain association request.

    • domainAssociation (dict) --

      Describes the structure of a domain association, which associates a custom domain with an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --

      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • updateStatus (string) --

        The status of the domain update operation that is currently in progress. The following list describes the valid update states.

        REQUESTING_CERTIFICATE

        The certificate is in the process of being updated.

        PENDING_VERIFICATION

        Indicates that an Amplify managed certificate is in the process of being verified. This occurs during the creation of a custom domain or when a custom domain is updated to use a managed certificate.

        IMPORTING_CUSTOM_CERTIFICATE

        Indicates that an Amplify custom certificate is in the process of being imported. This occurs during the creation of a custom domain or when a custom domain is updated to use a custom certificate.

        PENDING_DEPLOYMENT

        Indicates that the subdomain or certificate changes are being propagated.

        AWAITING_APP_CNAME

        Amplify is waiting for CNAME records corresponding to subdomains to be propagated. If your custom domain is on Route 53, Amplify handles this for you automatically. For more information about custom domains, see Setting up custom domains in the Amplify Hosting User Guide .

        UPDATE_COMPLETE

        The certificate has been associated with a domain.

        UPDATE_FAILED

        The certificate has failed to be provisioned or associated, and there is no existing active certificate to roll back to.

      • statusReason (string) --

        Additional information that describes why the domain association is in the current state.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

      • certificate (dict) --

        Describes the SSL/TLS certificate for the domain association. This can be your own custom certificate or the default certificate that Amplify provisions for you.

        If you are updating your domain to use a different certificate, certificate points to the new certificate that is being created instead of the current active certificate. Otherwise, certificate points to the current active certificate.

        • type (string) --

          The type of SSL/TLS certificate that you want to use.

          Specify AMPLIFY_MANAGED to use the default certificate that Amplify provisions for you.

          Specify CUSTOM to use your own certificate that you have already added to Certificate Manager in your Amazon Web Services account. Make sure you request (or import) the certificate in the US East (N. Virginia) Region (us-east-1). For more information about using ACM, see Importing certificates into Certificate Manager in the ACM User guide .

        • customCertificateArn (string) --

          The Amazon resource name (ARN) for a custom certificate that you have already added to Certificate Manager in your Amazon Web Services account.

          This field is required only when the certificate type is CUSTOM .

        • certificateVerificationDNSRecord (string) --

          The DNS record for certificate verification.

DeleteDomainAssociation (updated) Link ¶
Changes (response)
{'domainAssociation': {'certificate': {'certificateVerificationDNSRecord': 'string',
                                       'customCertificateArn': 'string',
                                       'type': 'AMPLIFY_MANAGED | CUSTOM'},
                       'domainStatus': {'AWAITING_APP_CNAME',
                                        'IMPORTING_CUSTOM_CERTIFICATE'},
                       'updateStatus': 'REQUESTING_CERTIFICATE | '
                                       'PENDING_VERIFICATION | '
                                       'IMPORTING_CUSTOM_CERTIFICATE | '
                                       'PENDING_DEPLOYMENT | '
                                       'AWAITING_APP_CNAME | UPDATE_COMPLETE | '
                                       'UPDATE_FAILED'}}

Deletes a domain association for an Amplify app.

See also: AWS API Documentation

Request Syntax

client.delete_domain_association(
    appId='string',
    domainName='string'
)
type appId

string

param appId

[REQUIRED]

The unique id for an Amplify app.

type domainName

string

param domainName

[REQUIRED]

The name of the domain.

rtype

dict

returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'updateStatus': 'REQUESTING_CERTIFICATE'|'PENDING_VERIFICATION'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'UPDATE_COMPLETE'|'UPDATE_FAILED',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ],
        'certificate': {
            'type': 'AMPLIFY_MANAGED'|'CUSTOM',
            'customCertificateArn': 'string',
            'certificateVerificationDNSRecord': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • domainAssociation (dict) --

      Describes the association between a custom domain and an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --

      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • updateStatus (string) --

        The status of the domain update operation that is currently in progress. The following list describes the valid update states.

        REQUESTING_CERTIFICATE

        The certificate is in the process of being updated.

        PENDING_VERIFICATION

        Indicates that an Amplify managed certificate is in the process of being verified. This occurs during the creation of a custom domain or when a custom domain is updated to use a managed certificate.

        IMPORTING_CUSTOM_CERTIFICATE

        Indicates that an Amplify custom certificate is in the process of being imported. This occurs during the creation of a custom domain or when a custom domain is updated to use a custom certificate.

        PENDING_DEPLOYMENT

        Indicates that the subdomain or certificate changes are being propagated.

        AWAITING_APP_CNAME

        Amplify is waiting for CNAME records corresponding to subdomains to be propagated. If your custom domain is on Route 53, Amplify handles this for you automatically. For more information about custom domains, see Setting up custom domains in the Amplify Hosting User Guide .

        UPDATE_COMPLETE

        The certificate has been associated with a domain.

        UPDATE_FAILED

        The certificate has failed to be provisioned or associated, and there is no existing active certificate to roll back to.

      • statusReason (string) --

        Additional information that describes why the domain association is in the current state.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

      • certificate (dict) --

        Describes the SSL/TLS certificate for the domain association. This can be your own custom certificate or the default certificate that Amplify provisions for you.

        If you are updating your domain to use a different certificate, certificate points to the new certificate that is being created instead of the current active certificate. Otherwise, certificate points to the current active certificate.

        • type (string) --

          The type of SSL/TLS certificate that you want to use.

          Specify AMPLIFY_MANAGED to use the default certificate that Amplify provisions for you.

          Specify CUSTOM to use your own certificate that you have already added to Certificate Manager in your Amazon Web Services account. Make sure you request (or import) the certificate in the US East (N. Virginia) Region (us-east-1). For more information about using ACM, see Importing certificates into Certificate Manager in the ACM User guide .

        • customCertificateArn (string) --

          The Amazon resource name (ARN) for a custom certificate that you have already added to Certificate Manager in your Amazon Web Services account.

          This field is required only when the certificate type is CUSTOM .

        • certificateVerificationDNSRecord (string) --

          The DNS record for certificate verification.

GetDomainAssociation (updated) Link ¶
Changes (response)
{'domainAssociation': {'certificate': {'certificateVerificationDNSRecord': 'string',
                                       'customCertificateArn': 'string',
                                       'type': 'AMPLIFY_MANAGED | CUSTOM'},
                       'domainStatus': {'AWAITING_APP_CNAME',
                                        'IMPORTING_CUSTOM_CERTIFICATE'},
                       'updateStatus': 'REQUESTING_CERTIFICATE | '
                                       'PENDING_VERIFICATION | '
                                       'IMPORTING_CUSTOM_CERTIFICATE | '
                                       'PENDING_DEPLOYMENT | '
                                       'AWAITING_APP_CNAME | UPDATE_COMPLETE | '
                                       'UPDATE_FAILED'}}

Returns the domain information for an Amplify app.

See also: AWS API Documentation

Request Syntax

client.get_domain_association(
    appId='string',
    domainName='string'
)
type appId

string

param appId

[REQUIRED]

The unique id for an Amplify app.

type domainName

string

param domainName

[REQUIRED]

The name of the domain.

rtype

dict

returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'updateStatus': 'REQUESTING_CERTIFICATE'|'PENDING_VERIFICATION'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'UPDATE_COMPLETE'|'UPDATE_FAILED',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ],
        'certificate': {
            'type': 'AMPLIFY_MANAGED'|'CUSTOM',
            'customCertificateArn': 'string',
            'certificateVerificationDNSRecord': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The result structure for the get domain association request.

    • domainAssociation (dict) --

      Describes the structure of a domain association, which associates a custom domain with an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --

      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • updateStatus (string) --

        The status of the domain update operation that is currently in progress. The following list describes the valid update states.

        REQUESTING_CERTIFICATE

        The certificate is in the process of being updated.

        PENDING_VERIFICATION

        Indicates that an Amplify managed certificate is in the process of being verified. This occurs during the creation of a custom domain or when a custom domain is updated to use a managed certificate.

        IMPORTING_CUSTOM_CERTIFICATE

        Indicates that an Amplify custom certificate is in the process of being imported. This occurs during the creation of a custom domain or when a custom domain is updated to use a custom certificate.

        PENDING_DEPLOYMENT

        Indicates that the subdomain or certificate changes are being propagated.

        AWAITING_APP_CNAME

        Amplify is waiting for CNAME records corresponding to subdomains to be propagated. If your custom domain is on Route 53, Amplify handles this for you automatically. For more information about custom domains, see Setting up custom domains in the Amplify Hosting User Guide .

        UPDATE_COMPLETE

        The certificate has been associated with a domain.

        UPDATE_FAILED

        The certificate has failed to be provisioned or associated, and there is no existing active certificate to roll back to.

      • statusReason (string) --

        Additional information that describes why the domain association is in the current state.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

      • certificate (dict) --

        Describes the SSL/TLS certificate for the domain association. This can be your own custom certificate or the default certificate that Amplify provisions for you.

        If you are updating your domain to use a different certificate, certificate points to the new certificate that is being created instead of the current active certificate. Otherwise, certificate points to the current active certificate.

        • type (string) --

          The type of SSL/TLS certificate that you want to use.

          Specify AMPLIFY_MANAGED to use the default certificate that Amplify provisions for you.

          Specify CUSTOM to use your own certificate that you have already added to Certificate Manager in your Amazon Web Services account. Make sure you request (or import) the certificate in the US East (N. Virginia) Region (us-east-1). For more information about using ACM, see Importing certificates into Certificate Manager in the ACM User guide .

        • customCertificateArn (string) --

          The Amazon resource name (ARN) for a custom certificate that you have already added to Certificate Manager in your Amazon Web Services account.

          This field is required only when the certificate type is CUSTOM .

        • certificateVerificationDNSRecord (string) --

          The DNS record for certificate verification.

ListDomainAssociations (updated) Link ¶
Changes (response)
{'domainAssociations': {'certificate': {'certificateVerificationDNSRecord': 'string',
                                        'customCertificateArn': 'string',
                                        'type': 'AMPLIFY_MANAGED | CUSTOM'},
                        'domainStatus': {'AWAITING_APP_CNAME',
                                         'IMPORTING_CUSTOM_CERTIFICATE'},
                        'updateStatus': 'REQUESTING_CERTIFICATE | '
                                        'PENDING_VERIFICATION | '
                                        'IMPORTING_CUSTOM_CERTIFICATE | '
                                        'PENDING_DEPLOYMENT | '
                                        'AWAITING_APP_CNAME | UPDATE_COMPLETE '
                                        '| UPDATE_FAILED'}}

Returns the domain associations for an Amplify app.

See also: AWS API Documentation

Request Syntax

client.list_domain_associations(
    appId='string',
    nextToken='string',
    maxResults=123
)
type appId

string

param appId

[REQUIRED]

The unique ID for an Amplify app.

type nextToken

string

param nextToken

A pagination token. Set to null to start listing apps from the start. If non-null, a pagination token is returned in a result. Pass its value in here to list more projects.

type maxResults

integer

param maxResults

The maximum number of records to list in a single response.

rtype

dict

returns

Response Syntax

{
    'domainAssociations': [
        {
            'domainAssociationArn': 'string',
            'domainName': 'string',
            'enableAutoSubDomain': True|False,
            'autoSubDomainCreationPatterns': [
                'string',
            ],
            'autoSubDomainIAMRole': 'string',
            'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
            'updateStatus': 'REQUESTING_CERTIFICATE'|'PENDING_VERIFICATION'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'UPDATE_COMPLETE'|'UPDATE_FAILED',
            'statusReason': 'string',
            'certificateVerificationDNSRecord': 'string',
            'subDomains': [
                {
                    'subDomainSetting': {
                        'prefix': 'string',
                        'branchName': 'string'
                    },
                    'verified': True|False,
                    'dnsRecord': 'string'
                },
            ],
            'certificate': {
                'type': 'AMPLIFY_MANAGED'|'CUSTOM',
                'customCertificateArn': 'string',
                'certificateVerificationDNSRecord': 'string'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list domain association request.

    • domainAssociations (list) --

      A list of domain associations.

      • (dict) --

        Describes the association between a custom domain and an Amplify app.

        • domainAssociationArn (string) --

          The Amazon Resource Name (ARN) for the domain association.

        • domainName (string) --

          The name of the domain.

        • enableAutoSubDomain (boolean) --

          Enables the automated creation of subdomains for branches.

        • autoSubDomainCreationPatterns (list) --

          Sets branch patterns for automatic subdomain creation.

          • (string) --

        • autoSubDomainIAMRole (string) --

          The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

        • domainStatus (string) --

          The current status of the domain association.

        • updateStatus (string) --

          The status of the domain update operation that is currently in progress. The following list describes the valid update states.

          REQUESTING_CERTIFICATE

          The certificate is in the process of being updated.

          PENDING_VERIFICATION

          Indicates that an Amplify managed certificate is in the process of being verified. This occurs during the creation of a custom domain or when a custom domain is updated to use a managed certificate.

          IMPORTING_CUSTOM_CERTIFICATE

          Indicates that an Amplify custom certificate is in the process of being imported. This occurs during the creation of a custom domain or when a custom domain is updated to use a custom certificate.

          PENDING_DEPLOYMENT

          Indicates that the subdomain or certificate changes are being propagated.

          AWAITING_APP_CNAME

          Amplify is waiting for CNAME records corresponding to subdomains to be propagated. If your custom domain is on Route 53, Amplify handles this for you automatically. For more information about custom domains, see Setting up custom domains in the Amplify Hosting User Guide .

          UPDATE_COMPLETE

          The certificate has been associated with a domain.

          UPDATE_FAILED

          The certificate has failed to be provisioned or associated, and there is no existing active certificate to roll back to.

        • statusReason (string) --

          Additional information that describes why the domain association is in the current state.

        • certificateVerificationDNSRecord (string) --

          The DNS record for certificate verification.

        • subDomains (list) --

          The subdomains for the domain association.

          • (dict) --

            The subdomain for the domain association.

            • subDomainSetting (dict) --

              Describes the settings for the subdomain.

              • prefix (string) --

                The prefix setting for the subdomain.

              • branchName (string) --

                The branch name setting for the subdomain.

            • verified (boolean) --

              The verified status of the subdomain

            • dnsRecord (string) --

              The DNS record for the subdomain.

        • certificate (dict) --

          Describes the SSL/TLS certificate for the domain association. This can be your own custom certificate or the default certificate that Amplify provisions for you.

          If you are updating your domain to use a different certificate, certificate points to the new certificate that is being created instead of the current active certificate. Otherwise, certificate points to the current active certificate.

          • type (string) --

            The type of SSL/TLS certificate that you want to use.

            Specify AMPLIFY_MANAGED to use the default certificate that Amplify provisions for you.

            Specify CUSTOM to use your own certificate that you have already added to Certificate Manager in your Amazon Web Services account. Make sure you request (or import) the certificate in the US East (N. Virginia) Region (us-east-1). For more information about using ACM, see Importing certificates into Certificate Manager in the ACM User guide .

          • customCertificateArn (string) --

            The Amazon resource name (ARN) for a custom certificate that you have already added to Certificate Manager in your Amazon Web Services account.

            This field is required only when the certificate type is CUSTOM .

          • certificateVerificationDNSRecord (string) --

            The DNS record for certificate verification.

    • nextToken (string) --

      A pagination token. If non-null, a pagination token is returned in a result. Pass its value in another request to retrieve more entries.

UpdateDomainAssociation (updated) Link ¶
Changes (request, response)
Request
{'certificateSettings': {'customCertificateArn': 'string',
                         'type': 'AMPLIFY_MANAGED | CUSTOM'}}
Response
{'domainAssociation': {'certificate': {'certificateVerificationDNSRecord': 'string',
                                       'customCertificateArn': 'string',
                                       'type': 'AMPLIFY_MANAGED | CUSTOM'},
                       'domainStatus': {'AWAITING_APP_CNAME',
                                        'IMPORTING_CUSTOM_CERTIFICATE'},
                       'updateStatus': 'REQUESTING_CERTIFICATE | '
                                       'PENDING_VERIFICATION | '
                                       'IMPORTING_CUSTOM_CERTIFICATE | '
                                       'PENDING_DEPLOYMENT | '
                                       'AWAITING_APP_CNAME | UPDATE_COMPLETE | '
                                       'UPDATE_FAILED'}}

Creates a new domain association for an Amplify app.

See also: AWS API Documentation

Request Syntax

client.update_domain_association(
    appId='string',
    domainName='string',
    enableAutoSubDomain=True|False,
    subDomainSettings=[
        {
            'prefix': 'string',
            'branchName': 'string'
        },
    ],
    autoSubDomainCreationPatterns=[
        'string',
    ],
    autoSubDomainIAMRole='string',
    certificateSettings={
        'type': 'AMPLIFY_MANAGED'|'CUSTOM',
        'customCertificateArn': 'string'
    }
)
type appId

string

param appId

[REQUIRED]

The unique ID for an Amplify app.

type domainName

string

param domainName

[REQUIRED]

The name of the domain.

type enableAutoSubDomain

boolean

param enableAutoSubDomain

Enables the automated creation of subdomains for branches.

type subDomainSettings

list

param subDomainSettings

Describes the settings for the subdomain.

  • (dict) --

    Describes the settings for the subdomain.

    • prefix (string) -- [REQUIRED]

      The prefix setting for the subdomain.

    • branchName (string) -- [REQUIRED]

      The branch name setting for the subdomain.

type autoSubDomainCreationPatterns

list

param autoSubDomainCreationPatterns

Sets the branch patterns for automatic subdomain creation.

  • (string) --

type autoSubDomainIAMRole

string

param autoSubDomainIAMRole

The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

type certificateSettings

dict

param certificateSettings

The type of SSL/TLS certificate to use for your custom domain.

  • type (string) -- [REQUIRED]

    The certificate type.

    Specify AMPLIFY_MANAGED to use the default certificate that Amplify provisions for you.

    Specify CUSTOM to use your own certificate that you have already added to Certificate Manager in your Amazon Web Services account. Make sure you request (or import) the certificate in the US East (N. Virginia) Region (us-east-1). For more information about using ACM, see Importing certificates into Certificate Manager in the ACM User guide .

  • customCertificateArn (string) --

    The Amazon resource name (ARN) for the custom certificate that you have already added to Certificate Manager in your Amazon Web Services account.

    This field is required only when the certificate type is CUSTOM .

rtype

dict

returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'updateStatus': 'REQUESTING_CERTIFICATE'|'PENDING_VERIFICATION'|'IMPORTING_CUSTOM_CERTIFICATE'|'PENDING_DEPLOYMENT'|'AWAITING_APP_CNAME'|'UPDATE_COMPLETE'|'UPDATE_FAILED',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ],
        'certificate': {
            'type': 'AMPLIFY_MANAGED'|'CUSTOM',
            'customCertificateArn': 'string',
            'certificateVerificationDNSRecord': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The result structure for the update domain association request.

    • domainAssociation (dict) --

      Describes a domain association, which associates a custom domain with an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --

      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • updateStatus (string) --

        The status of the domain update operation that is currently in progress. The following list describes the valid update states.

        REQUESTING_CERTIFICATE

        The certificate is in the process of being updated.

        PENDING_VERIFICATION

        Indicates that an Amplify managed certificate is in the process of being verified. This occurs during the creation of a custom domain or when a custom domain is updated to use a managed certificate.

        IMPORTING_CUSTOM_CERTIFICATE

        Indicates that an Amplify custom certificate is in the process of being imported. This occurs during the creation of a custom domain or when a custom domain is updated to use a custom certificate.

        PENDING_DEPLOYMENT

        Indicates that the subdomain or certificate changes are being propagated.

        AWAITING_APP_CNAME

        Amplify is waiting for CNAME records corresponding to subdomains to be propagated. If your custom domain is on Route 53, Amplify handles this for you automatically. For more information about custom domains, see Setting up custom domains in the Amplify Hosting User Guide .

        UPDATE_COMPLETE

        The certificate has been associated with a domain.

        UPDATE_FAILED

        The certificate has failed to be provisioned or associated, and there is no existing active certificate to roll back to.

      • statusReason (string) --

        Additional information that describes why the domain association is in the current state.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

      • certificate (dict) --

        Describes the SSL/TLS certificate for the domain association. This can be your own custom certificate or the default certificate that Amplify provisions for you.

        If you are updating your domain to use a different certificate, certificate points to the new certificate that is being created instead of the current active certificate. Otherwise, certificate points to the current active certificate.

        • type (string) --

          The type of SSL/TLS certificate that you want to use.

          Specify AMPLIFY_MANAGED to use the default certificate that Amplify provisions for you.

          Specify CUSTOM to use your own certificate that you have already added to Certificate Manager in your Amazon Web Services account. Make sure you request (or import) the certificate in the US East (N. Virginia) Region (us-east-1). For more information about using ACM, see Importing certificates into Certificate Manager in the ACM User guide .

        • customCertificateArn (string) --

          The Amazon resource name (ARN) for a custom certificate that you have already added to Certificate Manager in your Amazon Web Services account.

          This field is required only when the certificate type is CUSTOM .

        • certificateVerificationDNSRecord (string) --

          The DNS record for certificate verification.