CreateAccessPointForObjectLambda
Note
This operation is not supported by directory buckets.
Creates an Object Lambda Access Point. For more information, see Transforming objects with Object Lambda Access Points in the Amazon S3 User Guide.
The following actions are related to
CreateAccessPointForObjectLambda:
Request Syntax
PUT /v20180820/accesspointforobjectlambda/name HTTP/1.1
Host: s3-control.amazonaws.com
x-amz-account-id: AccountId
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectLambdaRequest xmlns="http://awss3control.amazonaws.com/doc/2018-08-20/">
<Configuration>
<AllowedFeatures>
<AllowedFeature>string</AllowedFeature>
</AllowedFeatures>
<CloudWatchMetricsEnabled>boolean</CloudWatchMetricsEnabled>
<SupportingAccessPoint>string</SupportingAccessPoint>
<TransformationConfigurations>
<TransformationConfiguration>
<Actions>
<Action>string</Action>
</Actions>
<ContentTransformation>
<AwsLambda>
<FunctionArn>string</FunctionArn>
<FunctionPayload>string</FunctionPayload>
</AwsLambda>
</ContentTransformation>
</TransformationConfiguration>
</TransformationConfigurations>
</Configuration>
</CreateAccessPointForObjectLambdaRequest>URI Request Parameters
The request uses the following URI parameters.
- name
-
The name you want to assign to this Object Lambda Access Point.
Length Constraints: Minimum length of 3. Maximum length of 45.
Pattern:
^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$Required: Yes
- x-amz-account-id
-
The AWS account ID for owner of the specified Object Lambda Access Point.
Length Constraints: Maximum length of 64.
Pattern:
^\d{12}$Required: Yes
Request Body
The request accepts the following data in XML format.
- CreateAccessPointForObjectLambdaRequest
-
Root level tag for the CreateAccessPointForObjectLambdaRequest parameters.
Required: Yes
- Configuration
-
Object Lambda Access Point configuration as a JSON document.
Type: ObjectLambdaConfiguration data type
Required: Yes
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectLambdaResult>
<ObjectLambdaAccessPointArn>string</ObjectLambdaAccessPointArn>
<Alias>
<Status>string</Status>
<Value>string</Value>
</Alias>
</CreateAccessPointForObjectLambdaResult>Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- CreateAccessPointForObjectLambdaResult
-
Root level tag for the CreateAccessPointForObjectLambdaResult parameters.
Required: Yes
- Alias
-
The alias of the Object Lambda Access Point.
Type: ObjectLambdaAccessPointAlias data type
- ObjectLambdaAccessPointArn
-
Specifies the ARN for the Object Lambda Access Point.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
Pattern:
arn:[^:]+:s3-object-lambda:[^:]*:\d{12}:accesspoint/.*
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
