README
¶
CDK Resource Interfaces
This module contains resource interfaces for all AWS service resources.
These are interfaces that look like this:
/**
* Indicates that this resource can be referenced as a Bucket.
*/
interface IBucketRef {
/**
* A reference to a Bucket resource.
*/
readonly bucketRef: BucketReference;
}
interface BucketReference {
/**
* The BucketName of the Bucket resource.
*/
readonly bucketName: string;
/**
* The ARN of the Bucket resource.
*/
readonly bucketArn: string;
}
These are in a separate submodule so that they can be referenced from all other service submodules without introducing cyclic dependencies between them.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type IEnvironmentAware ¶
type IEnvironmentAware interface {
// The environment this resource belongs to.
//
// For resources that are created and managed in a Stack (those created by
// creating new class instances like `new Role()`, `new Bucket()`, etc.), this
// is always the same as the environment of the stack they belong to.
//
// For referenced resources (those obtained from referencing methods like
// `Role.fromRoleArn()`, `Bucket.fromBucketName()`, etc.), they might be
// different than the stack they were imported into.
Env() *ResourceEnvironment
}
Used to indicate that a particular construct has an resource environment.
type ResourceEnvironment ¶
type ResourceEnvironment struct {
// The AWS Account ID that this resource belongs to.
//
// Since this can be a Token (for example, when the account is
// CloudFormation's `AWS::AccountId` intrinsic), make sure to use
// `Token.compareStrings()` instead of comparing the values with direct
// string equality.
Account *string `field:"required" json:"account" yaml:"account"`
// The AWS Region that this resource belongs to.
//
// Since this can be a Token (for example, when the region is CloudFormation's
// `AWS::Region` intrinsic), make sure to use `Token.compareStrings()` instead
// of comparing the values with direct string equality.
Region *string `field:"required" json:"region" yaml:"region"`
}
Represents the environment a given resource lives in.
Used as the return value for the `IEnvironmentAware.env` property.
Example:
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/constructs-go/constructs"
var scope Construct
type myFactory struct {
}
func (this *myFactory) forResource(resource CfnResource) IResourceWithPolicyV2 {
return map[string]ResourceEnvironment{
"env": *resource.env,
(MethodDeclaration addToResourcePolicy(statement: PolicyStatement) {
// custom implementation to add the statement to the resource policy
return { statementAdded: true, policyDependable: resource };
}
addToResourcePolicy
statement PolicyStatement
{
// custom implementation to add the statement to the resource policy
return &AddToResourcePolicyResult{
"statementAdded": jsii.Boolean(true),
"policyDependable": resource,
}
}),
}
}
awscdk.ResourceWithPolicies_Register(scope, jsii.String("AWS::KMS::Key"), NewMyFactory())
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.