community.aws.aws_acm – Загрузка и удаление сертификатов в службе AWS Certificate Manager

• Описание
• Требования
• Параметры
• Примечания
• Примеры
• Значения возврата

Описание

• Импортирование и удаление сертификатов в службе управления сертификатами Amazon Web Services (AWS ACM).
• В настоящее время данный модуль не взаимодействует с сертификатами, предоставляемыми AWS. Он только управляет сертификатами, предоставленными пользователями AWS.
• API ACM позволяет пользователям загружать несколько сертификатов для одного доменного имени, а также несколько идентичных сертификатов. Этот модуль пытается ограничить такие возможности, чтобы быть идемпотентным, в соответствии с философией Ansible. Для этого он использует теги ресурсов AWS «Имя» для сертификатов ACM.
• При state=present, если в ACM есть один сертификат с тегом Name равным параметру name_tag, и идентичным телом и цепочкой, эта задача завершится без изменений.
• При state=present, если в ACM есть один сертификат с тегом Name, равным параметру name_tag, и другим телом, эта задача перезапишет этот сертификат.
• При state=present, если в ACM есть несколько сертификатов с тегом Name, равным параметру name_tag, эта задача завершится ошибкой.
• При state=absent и заданном certificate_arn, этот модуль удалит ресурс ACM с указанным ARN, если он существует в данной области, и завершится без изменений, если он не существует.
• При state=absent и заданном domain_name, этот модуль удалит все ресурсы ACM в данной области AWS с соответствующим доменным именем. Если их нет, он завершится без изменений.
• При state=absent и не заданном certificate_arn, и не заданном domain_name, этот модуль удалит все ресурсы ACM в данной области AWS с соответствующим тегом Name. Если их нет, он завершится без изменений.
• Обратите внимание, что этот модуль может не работать должным образом с ключами размером 4096 бит из-за ограничения API ACM.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

• boto
• boto3
• python >= 2.6

Параметры

Примечания

Примеры

- name: upload a self-signed certificate
  community.aws.aws_acm:
    certificate: "{{ lookup('file', 'cert.pem' ) }}"
    privateKey: "{{ lookup('file', 'key.pem' ) }}"
    name_tag: my_cert # to be applied through an AWS tag as  "Name":"my_cert"
    region: ap-southeast-2 # AWS region

- name: create/update a certificate with a chain
  community.aws.aws_acm:
    certificate: "{{ lookup('file', 'cert.pem' ) }}"
    privateKey: "{{ lookup('file', 'key.pem' ) }}"
    name_tag: my_cert
    certificate_chain: "{{ lookup('file', 'chain.pem' ) }}"
    state: present
    region: ap-southeast-2
  register: cert_create

- name: print ARN of cert we just created
  ansible.builtin.debug:
    var: cert_create.certificate.arn

- name: delete the cert we just created
  community.aws.aws_acm:
    name_tag: my_cert
    state: absent
    region: ap-southeast-2

- name: delete a certificate with a particular ARN
  community.aws.aws_acm:
    certificate_arn: "arn:aws:acm:ap-southeast-2:123456789012:certificate/01234567-abcd-abcd-abcd-012345678901"
    state: absent
    region: ap-southeast-2

- name: delete all certificates with a particular domain name
  community.aws.aws_acm:
    domain_name: acm.ansible.com
    state: absent
    region: ap-southeast-2

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Авторы

• Мэттью Дэвис (@matt-telstra) от имени Telstra Corporation Limited