permissions
Creates, updates, deletes or gets a permission
resource or lists permissions
in a region
Overview
Name | permissions |
Type | Resource |
Description | Permission set on private certificate authority |
Id | aws.acmpca.permissions |
Fields
Name | Datatype | Description |
---|---|---|
actions | array | The actions that the specified AWS service principal can use. Actions IssueCertificate, GetCertificate and ListPermissions must be provided. |
certificate_authority_arn | string | The Amazon Resource Name (ARN) of the Private Certificate Authority that grants the permission. |
principal | string | The AWS service or identity that receives the permission. At this time, the only valid principal is acm.amazonaws.com. |
source_account | string | The ID of the calling account. |
region | string | AWS region. |
Methods
Name | Accessible by | Required Params |
---|---|---|
create_resource | INSERT | Actions, CertificateAuthorityArn, Principal, region |
delete_resource | DELETE | data__Identifier, region |
get_resource | SELECT | data__Identifier, region |
SELECT
examples
Gets all properties from an individual permission
.
SELECT
region,
actions,
certificate_authority_arn,
principal,
source_account
FROM aws.acmpca.permissions
WHERE region = 'us-east-1' AND data__Identifier = '<CertificateAuthorityArn>|<Principal>';
INSERT
example
Use the following StackQL query and manifest file to create a new permission
resource, using stack-deploy
.
- Required Properties
- All Properties
- Manifest
/*+ create */
INSERT INTO aws.acmpca.permissions (
Actions,
CertificateAuthorityArn,
Principal,
region
)
SELECT
'{{ Actions }}',
'{{ CertificateAuthorityArn }}',
'{{ Principal }}',
'{{ region }}';
/*+ create */
INSERT INTO aws.acmpca.permissions (
Actions,
CertificateAuthorityArn,
Principal,
SourceAccount,
region
)
SELECT
'{{ Actions }}',
'{{ CertificateAuthorityArn }}',
'{{ Principal }}',
'{{ SourceAccount }}',
'{{ region }}';
version: 1
name: stack name
description: stack description
providers:
- aws
globals:
- name: region
value: '{{ vars.AWS_REGION }}'
resources:
- name: permission
props:
- name: Actions
value:
- '{{ Actions[0] }}'
- name: CertificateAuthorityArn
value: '{{ CertificateAuthorityArn }}'
- name: Principal
value: '{{ Principal }}'
- name: SourceAccount
value: '{{ SourceAccount }}'
DELETE
example
/*+ delete */
DELETE FROM aws.acmpca.permissions
WHERE data__Identifier = '<CertificateAuthorityArn|Principal>'
AND region = 'us-east-1';
Permissions
To operate on the permissions
resource, the following permissions are required:
Create
acm-pca:CreatePermission,
acm-pca:ListPermissions
Read
acm-pca:ListPermissions
Delete
acm-pca:DeletePermission