Aclp logs support

[sjer-akamai]

📝 Description

Adds support for monitor logs functionality
What does this PR do and why is this change necessary?

1. Adds full SDK support for monitor Logs API. This includes both the destinations and streams. This is a new feature not yet supported in the SDK.
2. Adds unit tests for newly implemented features.
3. Adds integration tests for newly implemented features.
4. Integration tests include safeguards based around the limitations of API.
   • The feature is currently in limited availability, these integration tests are skipped if the feature is not available for the account running tests.
   • Logs Stream functionality is limited to one stream per account. For this reason Logs stream tests will automatically skip if there's a stream existing on the account.
   • Full e2e test for streams require a stream to complete provisioning - based on experience during development this can take up to an hour. Similarly to what's already present for database related tests, an environment variable (run_aclp_logs_stream_tests) needs to be set as true or yes to enable testing the Stream portion of the API.
5. github workflow files were updated to include the run_aclp_logs_stream_tests environment variable.

Notes:

• Techdocs for stream POST and PUT requests mention destinations being "One or more unique identifiers for the sync points that will receive logs data." This differs from the actual API implementation: streams currently support only a single destination, and the API expects a single-element list in the request. This was confirmed with the team developing the ACLP Logs API, and a documentation update was requested.

✔️ How to Test

How do I run the relevant unit/integration tests?
Unit tests:

1. Follow usual installation/setup steps
2. run pytest test/unit to run all unit tests, or:
3. run pytest test/unit/objects/monitor_test.py to run only monitor related tests

Integration tests:

1. setup your linode token:
   • export LINODE_TOKEN="YOUR_REAL_TOKEN"
2. set environment variable to enable Logs Stream tests. This step is optional - if the variable is not set only destination related tests will run.
   • export RUN_ACLP_LOGS_STREAM_TESTS=true
3. run test suite:
   • make TEST_CASE=test_monitor_logs test-int

Notes:

• Integration tests will be skipped if account has no Akamai Cloud Pulse Logs account capability
• Stream integration tests will be skipped if another Logs stream is present on the account

[sjer-akamai]

Added missing signature to the commit, CI fails on lint because of PR title. Should I change it to something specific?

[yec-akamai]

Added missing signature to the commit, CI fails on lint because of PR title. Should I change it to something specific?

Just added label to your PR to pass the CI

[yec-akamai]

Tested and works well locally, nice work!