Troubleshooting shared transformation definitions
The following table lists messages that you might see, what causes them, and what to do.
| Message | Cause | What to do |
|---|---|---|
You don't have access to |
No active share gives your account access. For security, the message doesn't say whether the TD exists. | Check share list --incoming, and accept any pending invitation. Check that you're in the TD's Region, and that the ARN, including the owner's account ID, is exact. Ask the owner to confirm the share. |
This share lets you run ' |
atx custom def get on a share without download permission. |
Ask the owner to change the permission. |
You already accepted this share and can't leave it. Ask the owner to remove you. |
share decline on a share that you already accepted. |
Ask the owner to revoke the share. |
No active share |
The share was already revoked, or you're in another Region. | Check the Region and the share ID. |
Share ID must be a share ID (UUID) or a share ARN. |
The share ID isn't valid. | Copy the ID from share list. |
The invitation disappeared from share list --incoming. |
It expired after 12 hours. | Ask the owner to run share create again. |
A shared TD doesn't appear in atx custom def list. |
The invitation isn't accepted, you're in another Region, or the share was revoked. | Run share list --incoming in the TD's Region. |
This transformation definition is in |
You used a shared TD's ARN from another Region. | Set AWS_REGION to the Region in the ARN, and run the command again. |
This share doesn't accept learnings. Ask the owner to use the ExecuteWithLearningsAndContribution managed policy, or run without --share-learnings. |
--share-learnings on a share that doesn't allow contribution. |
Ask the owner to change the permission, or run without --share-learnings. |
Your IAM identity needs transform-custom:ContributeKnowledgeItems. |
Your IAM policy, or an SCP, doesn't allow contribution. | Ask your administrator to allow transform-custom:ContributeKnowledgeItems on the TD's ARN. |
Sharing learnings isn't available in this region yet. |
Lesson contribution isn't turned on in the Region. | Run without --share-learnings. |
Couldn't check whether this share accepts learnings. Try again, or run without --share-learnings. |
The CLI couldn't reach the service to check. | Run the command again. |
Revoke did not finish: |
Your IAM identity lacks transform-custom:DeleteResourcePolicy or transform-custom:PutResourcePolicy, so AWS RAM couldn't remove access. |
Add the permissions that the CLI names, and then run share revoke again. |
Your IAM identity needs ram: |
Your IAM principal lacks AWS RAM permissions. | See Identity-based policy examples for sharing. |