new: Support for Multicluster OBJ in object_keys module

[lgarber-akamai]

📝 Description

This pull request implements all of the changes to the object_keys module for Multicluster OBJ, including:

• New regions field
• New bucket_access.*.region field
• New update & change validation logic
• New object_keys_basic integration test

✔️ How to Test

The following test steps assume you have pulled down this PR locally and run make install.

Integration Testing

make TEST_ARGS="-v object_keys_basic object_basic" test

Manual Testing

1. In an Ansible collection sandbox environment (e.g. dx-devenv), run the following playbook:

---
- name: ansible_linode Sandbox Playbook
  hosts: localhost
  tasks:
  - set_fact:
      r: "{{ 1000000000 | random }}"

  - name: Create an OBJ key
    linode.cloud.object_keys:
      label: "ansible-test-{{ r }}"
      regions:
        - us-mia
        - us-iad
      state: present
    register: create

  - name: Create an S3 bucket using the key
    amazon.aws.s3_bucket:
      s3_url: "https://{{ create.key.regions[0].s3_endpoint }}/"
      aws_access_key: "{{ create.key.access_key }}"
      aws_secret_key: "{{ create.key.secret_key }}"
      name: "ansible-test-{{ r }}"
      state: present
    register: create_bucket

  - name: Create an OBJ key scoped to the new bucket
    linode.cloud.object_keys:
      label: "ansible-test-scoped-{{ r }}"
      regions:
        - us-ord
      access:
        - region: "{{ create.key.regions[0].id }}"
          bucket_name: "{{ create_bucket.name }}"
          permissions: read_write
      state: present

  - name: Update the regions of the new key
    linode.cloud.object_keys:
      label: "ansible-test-scoped-{{ r }}"
      regions:
        - us-ord
        - us-sea
      access:
        - region: "{{ create.key.regions[0].id }}"
          bucket_name: "{{ create_bucket.name }}"
          permissions: read_write
      state: present

2. Ensure the playbook runs successfully.
3. Ensure all output JSON matches the expected changes/behavior.

[lgarber-akamai]

This method contains a lot of logic just to raise an error, but I really wanted to make sure users would be informed if they attempted to update the bucket access configuration of a key

[zliang-akamai]

Works well, thanks for adding these new features!

[ezilber-akamai]

Nice work!