s3control

package
v0.19.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 30, 2020 License: Apache-2.0 Imports: 9 Imported by: 39

Documentation

Overview

Package s3control provides the client and types for making API requests to AWS S3 Control.

AWS S3 Control provides access to Amazon S3 control plane operations.

See https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20 for more information on this service.

See s3control package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/s3control/

Using the Client

To use AWS S3 Control with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the AWS S3 Control client for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/s3control/#New

Index

Constants

View Source
const (
	ServiceName = "AWS S3 Control" // Service's name
	ServiceID   = "S3Control"      // Service's identifier
	EndpointsID = "s3-control"     // Service's Endpoint identifier
)
View Source
const (

	// ErrCodeBadRequestException for service response error code
	// "BadRequestException".
	ErrCodeBadRequestException = "BadRequestException"

	// ErrCodeIdempotencyException for service response error code
	// "IdempotencyException".
	ErrCodeIdempotencyException = "IdempotencyException"

	// ErrCodeInternalServiceException for service response error code
	// "InternalServiceException".
	ErrCodeInternalServiceException = "InternalServiceException"

	// ErrCodeInvalidNextTokenException for service response error code
	// "InvalidNextTokenException".
	ErrCodeInvalidNextTokenException = "InvalidNextTokenException"

	// ErrCodeInvalidRequestException for service response error code
	// "InvalidRequestException".
	ErrCodeInvalidRequestException = "InvalidRequestException"

	// ErrCodeJobStatusException for service response error code
	// "JobStatusException".
	ErrCodeJobStatusException = "JobStatusException"

	// ErrCodeNoSuchPublicAccessBlockConfiguration for service response error code
	// "NoSuchPublicAccessBlockConfiguration".
	//
	// Amazon S3 throws this exception if you make a GetPublicAccessBlock request
	// against an account that doesn't have a PublicAccessBlockConfiguration set.
	ErrCodeNoSuchPublicAccessBlockConfiguration = "NoSuchPublicAccessBlockConfiguration"

	// ErrCodeNotFoundException for service response error code
	// "NotFoundException".
	ErrCodeNotFoundException = "NotFoundException"

	// ErrCodeTooManyRequestsException for service response error code
	// "TooManyRequestsException".
	ErrCodeTooManyRequestsException = "TooManyRequestsException"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AccessPoint added in v0.18.0

type AccessPoint struct {

	// The name of the bucket associated with this access point.
	//
	// Bucket is a required field
	Bucket *string `min:"3" type:"string" required:"true"`

	// The name of this access point.
	//
	// Name is a required field
	Name *string `min:"3" type:"string" required:"true"`

	// Indicates whether this access point allows access from the public Internet.
	// If VpcConfiguration is specified for this access point, then NetworkOrigin
	// is VPC, and the access point doesn't allow access from the public Internet.
	// Otherwise, NetworkOrigin is Internet, and the access point allows access
	// from the public Internet, subject to the access point and bucket access policies.
	//
	// NetworkOrigin is a required field
	NetworkOrigin NetworkOrigin `type:"string" required:"true" enum:"true"`

	// The Virtual Private Cloud (VPC) configuration for this access point, if one
	// exists.
	VpcConfiguration *VpcConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

An access point used to access a bucket.

func (AccessPoint) MarshalFields added in v0.18.0

func (s AccessPoint) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (AccessPoint) String added in v0.18.0

func (s AccessPoint) String() string

String returns the string representation

type Client added in v0.9.0

type Client struct {
	*aws.Client
}

Client provides the API operation methods for making requests to AWS S3 Control. See this package's package overview docs for details on the service.

The client's methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

func New

func New(config aws.Config) *Client

New creates a new instance of the client from the provided Config.

Example:

// Create a client from just a config.
svc := s3control.New(myConfig)

func (*Client) CreateAccessPointRequest added in v0.18.0

func (c *Client) CreateAccessPointRequest(input *CreateAccessPointInput) CreateAccessPointRequest

CreateAccessPointRequest returns a request value for making API operation for AWS S3 Control.

Creates an access point and associates it with the specified bucket.

// Example sending a request using CreateAccessPointRequest.
req := client.CreateAccessPointRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/CreateAccessPoint

func (*Client) CreateJobRequest added in v0.9.0

func (c *Client) CreateJobRequest(input *CreateJobInput) CreateJobRequest

CreateJobRequest returns a request value for making API operation for AWS S3 Control.

Creates an Amazon S3 batch operations job.

// Example sending a request using CreateJobRequest.
req := client.CreateJobRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/CreateJob

func (*Client) DeleteAccessPointPolicyRequest added in v0.18.0

func (c *Client) DeleteAccessPointPolicyRequest(input *DeleteAccessPointPolicyInput) DeleteAccessPointPolicyRequest

DeleteAccessPointPolicyRequest returns a request value for making API operation for AWS S3 Control.

Deletes the access point policy for the specified access point.

// Example sending a request using DeleteAccessPointPolicyRequest.
req := client.DeleteAccessPointPolicyRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DeleteAccessPointPolicy

func (*Client) DeleteAccessPointRequest added in v0.18.0

func (c *Client) DeleteAccessPointRequest(input *DeleteAccessPointInput) DeleteAccessPointRequest

DeleteAccessPointRequest returns a request value for making API operation for AWS S3 Control.

Deletes the specified access point.

// Example sending a request using DeleteAccessPointRequest.
req := client.DeleteAccessPointRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DeleteAccessPoint

func (*Client) DeletePublicAccessBlockRequest added in v0.9.0

func (c *Client) DeletePublicAccessBlockRequest(input *DeletePublicAccessBlockInput) DeletePublicAccessBlockRequest

DeletePublicAccessBlockRequest returns a request value for making API operation for AWS S3 Control.

Removes the PublicAccessBlock configuration for an Amazon Web Services account.

// Example sending a request using DeletePublicAccessBlockRequest.
req := client.DeletePublicAccessBlockRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DeletePublicAccessBlock

func (*Client) DescribeJobRequest added in v0.9.0

func (c *Client) DescribeJobRequest(input *DescribeJobInput) DescribeJobRequest

DescribeJobRequest returns a request value for making API operation for AWS S3 Control.

Retrieves the configuration parameters and status for a batch operations job.

// Example sending a request using DescribeJobRequest.
req := client.DescribeJobRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DescribeJob

func (*Client) GetAccessPointPolicyRequest added in v0.18.0

func (c *Client) GetAccessPointPolicyRequest(input *GetAccessPointPolicyInput) GetAccessPointPolicyRequest

GetAccessPointPolicyRequest returns a request value for making API operation for AWS S3 Control.

Returns the access point policy associated with the specified access point.

// Example sending a request using GetAccessPointPolicyRequest.
req := client.GetAccessPointPolicyRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetAccessPointPolicy

func (*Client) GetAccessPointPolicyStatusRequest added in v0.18.0

func (c *Client) GetAccessPointPolicyStatusRequest(input *GetAccessPointPolicyStatusInput) GetAccessPointPolicyStatusRequest

GetAccessPointPolicyStatusRequest returns a request value for making API operation for AWS S3 Control.

Indicates whether the specified access point currently has a policy that allows public access. For more information about public access through access points, see Managing Data Access with Amazon S3 Access Points (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html) in the Amazon Simple Storage Service Developer Guide.

// Example sending a request using GetAccessPointPolicyStatusRequest.
req := client.GetAccessPointPolicyStatusRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetAccessPointPolicyStatus

func (*Client) GetAccessPointRequest added in v0.18.0

func (c *Client) GetAccessPointRequest(input *GetAccessPointInput) GetAccessPointRequest

GetAccessPointRequest returns a request value for making API operation for AWS S3 Control.

Returns configuration information about the specified access point.

// Example sending a request using GetAccessPointRequest.
req := client.GetAccessPointRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetAccessPoint

func (*Client) GetPublicAccessBlockRequest added in v0.9.0

func (c *Client) GetPublicAccessBlockRequest(input *GetPublicAccessBlockInput) GetPublicAccessBlockRequest

GetPublicAccessBlockRequest returns a request value for making API operation for AWS S3 Control.

Retrieves the PublicAccessBlock configuration for an Amazon Web Services account.

// Example sending a request using GetPublicAccessBlockRequest.
req := client.GetPublicAccessBlockRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetPublicAccessBlock

func (*Client) ListAccessPointsRequest added in v0.18.0

func (c *Client) ListAccessPointsRequest(input *ListAccessPointsInput) ListAccessPointsRequest

ListAccessPointsRequest returns a request value for making API operation for AWS S3 Control.

Returns a list of the access points currently associated with the specified bucket. You can retrieve up to 1000 access points per call. If the specified bucket has more than 1000 access points (or the number specified in maxResults, whichever is less), then the response will include a continuation token that you can use to list the additional access points.

// Example sending a request using ListAccessPointsRequest.
req := client.ListAccessPointsRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/ListAccessPoints

func (*Client) ListJobsRequest added in v0.9.0

func (c *Client) ListJobsRequest(input *ListJobsInput) ListJobsRequest

ListJobsRequest returns a request value for making API operation for AWS S3 Control.

Lists current jobs and jobs that have ended within the last 30 days for the AWS account making the request.

// Example sending a request using ListJobsRequest.
req := client.ListJobsRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/ListJobs

func (*Client) PutAccessPointPolicyRequest added in v0.18.0

func (c *Client) PutAccessPointPolicyRequest(input *PutAccessPointPolicyInput) PutAccessPointPolicyRequest

PutAccessPointPolicyRequest returns a request value for making API operation for AWS S3 Control.

Associates an access policy with the specified access point. Each access point can have only one policy, so a request made to this API replaces any existing policy associated with the specified access point.

// Example sending a request using PutAccessPointPolicyRequest.
req := client.PutAccessPointPolicyRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutAccessPointPolicy

func (*Client) PutPublicAccessBlockRequest added in v0.9.0

func (c *Client) PutPublicAccessBlockRequest(input *PutPublicAccessBlockInput) PutPublicAccessBlockRequest

PutPublicAccessBlockRequest returns a request value for making API operation for AWS S3 Control.

Creates or modifies the PublicAccessBlock configuration for an Amazon Web Services account.

// Example sending a request using PutPublicAccessBlockRequest.
req := client.PutPublicAccessBlockRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutPublicAccessBlock

func (*Client) UpdateJobPriorityRequest added in v0.9.0

func (c *Client) UpdateJobPriorityRequest(input *UpdateJobPriorityInput) UpdateJobPriorityRequest

UpdateJobPriorityRequest returns a request value for making API operation for AWS S3 Control.

Updates an existing job's priority.

// Example sending a request using UpdateJobPriorityRequest.
req := client.UpdateJobPriorityRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/UpdateJobPriority

func (*Client) UpdateJobStatusRequest added in v0.9.0

func (c *Client) UpdateJobStatusRequest(input *UpdateJobStatusInput) UpdateJobStatusRequest

UpdateJobStatusRequest returns a request value for making API operation for AWS S3 Control.

Updates the status for the specified job. Use this operation to confirm that you want to run a job or to cancel an existing job.

// Example sending a request using UpdateJobStatusRequest.
req := client.UpdateJobStatusRequest(params)
resp, err := req.Send(context.TODO())
if err == nil {
    fmt.Println(resp)
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/UpdateJobStatus

type CreateAccessPointInput added in v0.18.0

type CreateAccessPointInput struct {

	// The AWS account ID for the owner of the bucket for which you want to create
	// an access point.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the bucket that you want to associate this access point with.
	//
	// Bucket is a required field
	Bucket *string `min:"3" type:"string" required:"true"`

	// The name you want to assign to this access point.
	//
	// Name is a required field
	Name *string `location:"uri" locationName:"name" min:"3" type:"string" required:"true"`

	// The PublicAccessBlock configuration that you want to apply to this Amazon
	// S3 bucket. You can enable the configuration options in any combination. For
	// more information about when Amazon S3 considers a bucket or object public,
	// see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status)
	// in the Amazon Simple Storage Service Developer Guide.
	PublicAccessBlockConfiguration *PublicAccessBlockConfiguration `type:"structure"`

	// If you include this field, Amazon S3 restricts access to this access point
	// to requests from the specified Virtual Private Cloud (VPC).
	VpcConfiguration *VpcConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (CreateAccessPointInput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (CreateAccessPointInput) String added in v0.18.0

func (s CreateAccessPointInput) String() string

String returns the string representation

func (*CreateAccessPointInput) Validate added in v0.18.0

func (s *CreateAccessPointInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateAccessPointOutput added in v0.18.0

type CreateAccessPointOutput struct {
	// contains filtered or unexported fields
}

func (CreateAccessPointOutput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (CreateAccessPointOutput) String added in v0.18.0

func (s CreateAccessPointOutput) String() string

String returns the string representation

type CreateAccessPointRequest added in v0.18.0

type CreateAccessPointRequest struct {
	*aws.Request
	Input *CreateAccessPointInput
	Copy  func(*CreateAccessPointInput) CreateAccessPointRequest
}

CreateAccessPointRequest is the request type for the CreateAccessPoint API operation.

func (CreateAccessPointRequest) Send added in v0.18.0

Send marshals and sends the CreateAccessPoint API request.

type CreateAccessPointResponse added in v0.18.0

type CreateAccessPointResponse struct {
	*CreateAccessPointOutput
	// contains filtered or unexported fields
}

CreateAccessPointResponse is the response type for the CreateAccessPoint API operation.

func (*CreateAccessPointResponse) SDKResponseMetdata added in v0.18.0

func (r *CreateAccessPointResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the CreateAccessPoint request.

type CreateJobInput added in v0.9.0

type CreateJobInput struct {

	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// An idempotency token to ensure that you don't accidentally submit the same
	// request twice. You can use any string up to the maximum length.
	//
	// ClientRequestToken is a required field
	ClientRequestToken *string `min:"1" type:"string" required:"true" idempotencyToken:"true"`

	// Indicates whether confirmation is required before Amazon S3 runs the job.
	// Confirmation is only required for jobs created through the Amazon S3 console.
	ConfirmationRequired *bool `type:"boolean"`

	// A description for this job. You can use any string within the permitted length.
	// Descriptions don't need to be unique and can be used for multiple jobs.
	Description *string `min:"1" type:"string"`

	// Configuration parameters for the manifest.
	//
	// Manifest is a required field
	Manifest *JobManifest `type:"structure" required:"true"`

	// The operation that you want this job to perform on each object listed in
	// the manifest. For more information about the available operations, see Available
	// Operations (https://docs.aws.amazon.com/AmazonS3/latest/dev/batch-ops-operations.html)
	// in the Amazon Simple Storage Service Developer Guide.
	//
	// Operation is a required field
	Operation *JobOperation `type:"structure" required:"true"`

	// The numerical priority for this job. Higher numbers indicate higher priority.
	//
	// Priority is a required field
	Priority *int64 `type:"integer" required:"true"`

	// Configuration parameters for the optional job-completion report.
	//
	// Report is a required field
	Report *JobReport `type:"structure" required:"true"`

	// The Amazon Resource Name (ARN) for the Identity and Access Management (IAM)
	// Role that batch operations will use to execute this job's operation on each
	// object in the manifest.
	//
	// RoleArn is a required field
	RoleArn *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CreateJobInput) MarshalFields added in v0.9.0

func (s CreateJobInput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (CreateJobInput) String added in v0.9.0

func (s CreateJobInput) String() string

String returns the string representation

func (*CreateJobInput) Validate added in v0.9.0

func (s *CreateJobInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateJobOutput added in v0.9.0

type CreateJobOutput struct {

	// The ID for this job. Amazon S3 generates this ID automatically and returns
	// it after a successful Create Job request.
	JobId *string `min:"5" type:"string"`
	// contains filtered or unexported fields
}

func (CreateJobOutput) MarshalFields added in v0.9.0

func (s CreateJobOutput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (CreateJobOutput) String added in v0.9.0

func (s CreateJobOutput) String() string

String returns the string representation

type CreateJobRequest added in v0.9.0

type CreateJobRequest struct {
	*aws.Request
	Input *CreateJobInput
	Copy  func(*CreateJobInput) CreateJobRequest
}

CreateJobRequest is the request type for the CreateJob API operation.

func (CreateJobRequest) Send added in v0.9.0

Send marshals and sends the CreateJob API request.

type CreateJobResponse added in v0.9.0

type CreateJobResponse struct {
	*CreateJobOutput
	// contains filtered or unexported fields
}

CreateJobResponse is the response type for the CreateJob API operation.

func (*CreateJobResponse) SDKResponseMetdata added in v0.9.0

func (r *CreateJobResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the CreateJob request.

type DeleteAccessPointInput added in v0.18.0

type DeleteAccessPointInput struct {

	// The account ID for the account that owns the specified access point.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the access point you want to delete.
	//
	// Name is a required field
	Name *string `location:"uri" locationName:"name" min:"3" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteAccessPointInput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DeleteAccessPointInput) String added in v0.18.0

func (s DeleteAccessPointInput) String() string

String returns the string representation

func (*DeleteAccessPointInput) Validate added in v0.18.0

func (s *DeleteAccessPointInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteAccessPointOutput added in v0.18.0

type DeleteAccessPointOutput struct {
	// contains filtered or unexported fields
}

func (DeleteAccessPointOutput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DeleteAccessPointOutput) String added in v0.18.0

func (s DeleteAccessPointOutput) String() string

String returns the string representation

type DeleteAccessPointPolicyInput added in v0.18.0

type DeleteAccessPointPolicyInput struct {

	// The account ID for the account that owns the specified access point.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the access point whose policy you want to delete.
	//
	// Name is a required field
	Name *string `location:"uri" locationName:"name" min:"3" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteAccessPointPolicyInput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DeleteAccessPointPolicyInput) String added in v0.18.0

String returns the string representation

func (*DeleteAccessPointPolicyInput) Validate added in v0.18.0

func (s *DeleteAccessPointPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteAccessPointPolicyOutput added in v0.18.0

type DeleteAccessPointPolicyOutput struct {
	// contains filtered or unexported fields
}

func (DeleteAccessPointPolicyOutput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DeleteAccessPointPolicyOutput) String added in v0.18.0

String returns the string representation

type DeleteAccessPointPolicyRequest added in v0.18.0

type DeleteAccessPointPolicyRequest struct {
	*aws.Request
	Input *DeleteAccessPointPolicyInput
	Copy  func(*DeleteAccessPointPolicyInput) DeleteAccessPointPolicyRequest
}

DeleteAccessPointPolicyRequest is the request type for the DeleteAccessPointPolicy API operation.

func (DeleteAccessPointPolicyRequest) Send added in v0.18.0

Send marshals and sends the DeleteAccessPointPolicy API request.

type DeleteAccessPointPolicyResponse added in v0.18.0

type DeleteAccessPointPolicyResponse struct {
	*DeleteAccessPointPolicyOutput
	// contains filtered or unexported fields
}

DeleteAccessPointPolicyResponse is the response type for the DeleteAccessPointPolicy API operation.

func (*DeleteAccessPointPolicyResponse) SDKResponseMetdata added in v0.18.0

func (r *DeleteAccessPointPolicyResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the DeleteAccessPointPolicy request.

type DeleteAccessPointRequest added in v0.18.0

type DeleteAccessPointRequest struct {
	*aws.Request
	Input *DeleteAccessPointInput
	Copy  func(*DeleteAccessPointInput) DeleteAccessPointRequest
}

DeleteAccessPointRequest is the request type for the DeleteAccessPoint API operation.

func (DeleteAccessPointRequest) Send added in v0.18.0

Send marshals and sends the DeleteAccessPoint API request.

type DeleteAccessPointResponse added in v0.18.0

type DeleteAccessPointResponse struct {
	*DeleteAccessPointOutput
	// contains filtered or unexported fields
}

DeleteAccessPointResponse is the response type for the DeleteAccessPoint API operation.

func (*DeleteAccessPointResponse) SDKResponseMetdata added in v0.18.0

func (r *DeleteAccessPointResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the DeleteAccessPoint request.

type DeletePublicAccessBlockInput

type DeletePublicAccessBlockInput struct {

	// The account ID for the Amazon Web Services account whose PublicAccessBlock
	// configuration you want to remove.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeletePublicAccessBlockInput) MarshalFields

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DeletePublicAccessBlockInput) String

String returns the string representation

func (*DeletePublicAccessBlockInput) Validate

func (s *DeletePublicAccessBlockInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeletePublicAccessBlockOutput

type DeletePublicAccessBlockOutput struct {
	// contains filtered or unexported fields
}

func (DeletePublicAccessBlockOutput) MarshalFields

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DeletePublicAccessBlockOutput) String

String returns the string representation

type DeletePublicAccessBlockRequest

type DeletePublicAccessBlockRequest struct {
	*aws.Request
	Input *DeletePublicAccessBlockInput
	Copy  func(*DeletePublicAccessBlockInput) DeletePublicAccessBlockRequest
}

DeletePublicAccessBlockRequest is the request type for the DeletePublicAccessBlock API operation.

func (DeletePublicAccessBlockRequest) Send

Send marshals and sends the DeletePublicAccessBlock API request.

type DeletePublicAccessBlockResponse added in v0.9.0

type DeletePublicAccessBlockResponse struct {
	*DeletePublicAccessBlockOutput
	// contains filtered or unexported fields
}

DeletePublicAccessBlockResponse is the response type for the DeletePublicAccessBlock API operation.

func (*DeletePublicAccessBlockResponse) SDKResponseMetdata added in v0.9.0

func (r *DeletePublicAccessBlockResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the DeletePublicAccessBlock request.

type DescribeJobInput added in v0.9.0

type DescribeJobInput struct {

	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The ID for the job whose information you want to retrieve.
	//
	// JobId is a required field
	JobId *string `location:"uri" locationName:"id" min:"5" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DescribeJobInput) MarshalFields added in v0.9.0

func (s DescribeJobInput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DescribeJobInput) String added in v0.9.0

func (s DescribeJobInput) String() string

String returns the string representation

func (*DescribeJobInput) Validate added in v0.9.0

func (s *DescribeJobInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeJobOutput added in v0.9.0

type DescribeJobOutput struct {

	// Contains the configuration parameters and status for the job specified in
	// the Describe Job request.
	Job *JobDescriptor `type:"structure"`
	// contains filtered or unexported fields
}

func (DescribeJobOutput) MarshalFields added in v0.9.0

func (s DescribeJobOutput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (DescribeJobOutput) String added in v0.9.0

func (s DescribeJobOutput) String() string

String returns the string representation

type DescribeJobRequest added in v0.9.0

type DescribeJobRequest struct {
	*aws.Request
	Input *DescribeJobInput
	Copy  func(*DescribeJobInput) DescribeJobRequest
}

DescribeJobRequest is the request type for the DescribeJob API operation.

func (DescribeJobRequest) Send added in v0.9.0

Send marshals and sends the DescribeJob API request.

type DescribeJobResponse added in v0.9.0

type DescribeJobResponse struct {
	*DescribeJobOutput
	// contains filtered or unexported fields
}

DescribeJobResponse is the response type for the DescribeJob API operation.

func (*DescribeJobResponse) SDKResponseMetdata added in v0.9.0

func (r *DescribeJobResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the DescribeJob request.

type GetAccessPointInput added in v0.18.0

type GetAccessPointInput struct {

	// The account ID for the account that owns the specified access point.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the access point whose configuration information you want to
	// retrieve.
	//
	// Name is a required field
	Name *string `location:"uri" locationName:"name" min:"3" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetAccessPointInput) MarshalFields added in v0.18.0

func (s GetAccessPointInput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetAccessPointInput) String added in v0.18.0

func (s GetAccessPointInput) String() string

String returns the string representation

func (*GetAccessPointInput) Validate added in v0.18.0

func (s *GetAccessPointInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetAccessPointOutput added in v0.18.0

type GetAccessPointOutput struct {

	// The name of the bucket associated with the specified access point.
	Bucket *string `min:"3" type:"string"`

	// The date and time when the specified access point was created.
	CreationDate *time.Time `type:"timestamp"`

	// The name of the specified access point.
	Name *string `min:"3" type:"string"`

	// Indicates whether this access point allows access from the public Internet.
	// If VpcConfiguration is specified for this access point, then NetworkOrigin
	// is VPC, and the access point doesn't allow access from the public Internet.
	// Otherwise, NetworkOrigin is Internet, and the access point allows access
	// from the public Internet, subject to the access point and bucket access policies.
	NetworkOrigin NetworkOrigin `type:"string" enum:"true"`

	// The PublicAccessBlock configuration that you want to apply to this Amazon
	// S3 bucket. You can enable the configuration options in any combination. For
	// more information about when Amazon S3 considers a bucket or object public,
	// see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status)
	// in the Amazon Simple Storage Service Developer Guide.
	PublicAccessBlockConfiguration *PublicAccessBlockConfiguration `type:"structure"`

	// Contains the Virtual Private Cloud (VPC) configuration for the specified
	// access point.
	VpcConfiguration *VpcConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (GetAccessPointOutput) MarshalFields added in v0.18.0

func (s GetAccessPointOutput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetAccessPointOutput) String added in v0.18.0

func (s GetAccessPointOutput) String() string

String returns the string representation

type GetAccessPointPolicyInput added in v0.18.0

type GetAccessPointPolicyInput struct {

	// The account ID for the account that owns the specified access point.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the access point whose policy you want to retrieve.
	//
	// Name is a required field
	Name *string `location:"uri" locationName:"name" min:"3" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetAccessPointPolicyInput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetAccessPointPolicyInput) String added in v0.18.0

func (s GetAccessPointPolicyInput) String() string

String returns the string representation

func (*GetAccessPointPolicyInput) Validate added in v0.18.0

func (s *GetAccessPointPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetAccessPointPolicyOutput added in v0.18.0

type GetAccessPointPolicyOutput struct {

	// The access point policy associated with the specified access point.
	Policy *string `type:"string"`
	// contains filtered or unexported fields
}

func (GetAccessPointPolicyOutput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetAccessPointPolicyOutput) String added in v0.18.0

String returns the string representation

type GetAccessPointPolicyRequest added in v0.18.0

type GetAccessPointPolicyRequest struct {
	*aws.Request
	Input *GetAccessPointPolicyInput
	Copy  func(*GetAccessPointPolicyInput) GetAccessPointPolicyRequest
}

GetAccessPointPolicyRequest is the request type for the GetAccessPointPolicy API operation.

func (GetAccessPointPolicyRequest) Send added in v0.18.0

Send marshals and sends the GetAccessPointPolicy API request.

type GetAccessPointPolicyResponse added in v0.18.0

type GetAccessPointPolicyResponse struct {
	*GetAccessPointPolicyOutput
	// contains filtered or unexported fields
}

GetAccessPointPolicyResponse is the response type for the GetAccessPointPolicy API operation.

func (*GetAccessPointPolicyResponse) SDKResponseMetdata added in v0.18.0

func (r *GetAccessPointPolicyResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the GetAccessPointPolicy request.

type GetAccessPointPolicyStatusInput added in v0.18.0

type GetAccessPointPolicyStatusInput struct {

	// The account ID for the account that owns the specified access point.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the access point whose policy status you want to retrieve.
	//
	// Name is a required field
	Name *string `location:"uri" locationName:"name" min:"3" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetAccessPointPolicyStatusInput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetAccessPointPolicyStatusInput) String added in v0.18.0

String returns the string representation

func (*GetAccessPointPolicyStatusInput) Validate added in v0.18.0

func (s *GetAccessPointPolicyStatusInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetAccessPointPolicyStatusOutput added in v0.18.0

type GetAccessPointPolicyStatusOutput struct {

	// Indicates the current policy status of the specified access point.
	PolicyStatus *PolicyStatus `type:"structure"`
	// contains filtered or unexported fields
}

func (GetAccessPointPolicyStatusOutput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetAccessPointPolicyStatusOutput) String added in v0.18.0

String returns the string representation

type GetAccessPointPolicyStatusRequest added in v0.18.0

type GetAccessPointPolicyStatusRequest struct {
	*aws.Request
	Input *GetAccessPointPolicyStatusInput
	Copy  func(*GetAccessPointPolicyStatusInput) GetAccessPointPolicyStatusRequest
}

GetAccessPointPolicyStatusRequest is the request type for the GetAccessPointPolicyStatus API operation.

func (GetAccessPointPolicyStatusRequest) Send added in v0.18.0

Send marshals and sends the GetAccessPointPolicyStatus API request.

type GetAccessPointPolicyStatusResponse added in v0.18.0

type GetAccessPointPolicyStatusResponse struct {
	*GetAccessPointPolicyStatusOutput
	// contains filtered or unexported fields
}

GetAccessPointPolicyStatusResponse is the response type for the GetAccessPointPolicyStatus API operation.

func (*GetAccessPointPolicyStatusResponse) SDKResponseMetdata added in v0.18.0

func (r *GetAccessPointPolicyStatusResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the GetAccessPointPolicyStatus request.

type GetAccessPointRequest added in v0.18.0

type GetAccessPointRequest struct {
	*aws.Request
	Input *GetAccessPointInput
	Copy  func(*GetAccessPointInput) GetAccessPointRequest
}

GetAccessPointRequest is the request type for the GetAccessPoint API operation.

func (GetAccessPointRequest) Send added in v0.18.0

Send marshals and sends the GetAccessPoint API request.

type GetAccessPointResponse added in v0.18.0

type GetAccessPointResponse struct {
	*GetAccessPointOutput
	// contains filtered or unexported fields
}

GetAccessPointResponse is the response type for the GetAccessPoint API operation.

func (*GetAccessPointResponse) SDKResponseMetdata added in v0.18.0

func (r *GetAccessPointResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the GetAccessPoint request.

type GetPublicAccessBlockInput

type GetPublicAccessBlockInput struct {

	// The account ID for the Amazon Web Services account whose PublicAccessBlock
	// configuration you want to retrieve.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetPublicAccessBlockInput) MarshalFields

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetPublicAccessBlockInput) String

func (s GetPublicAccessBlockInput) String() string

String returns the string representation

func (*GetPublicAccessBlockInput) Validate

func (s *GetPublicAccessBlockInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetPublicAccessBlockOutput

type GetPublicAccessBlockOutput struct {

	// The PublicAccessBlock configuration currently in effect for this Amazon Web
	// Services account.
	PublicAccessBlockConfiguration *PublicAccessBlockConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (GetPublicAccessBlockOutput) MarshalFields

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (GetPublicAccessBlockOutput) String

String returns the string representation

type GetPublicAccessBlockRequest

type GetPublicAccessBlockRequest struct {
	*aws.Request
	Input *GetPublicAccessBlockInput
	Copy  func(*GetPublicAccessBlockInput) GetPublicAccessBlockRequest
}

GetPublicAccessBlockRequest is the request type for the GetPublicAccessBlock API operation.

func (GetPublicAccessBlockRequest) Send

Send marshals and sends the GetPublicAccessBlock API request.

type GetPublicAccessBlockResponse added in v0.9.0

type GetPublicAccessBlockResponse struct {
	*GetPublicAccessBlockOutput
	// contains filtered or unexported fields
}

GetPublicAccessBlockResponse is the response type for the GetPublicAccessBlock API operation.

func (*GetPublicAccessBlockResponse) SDKResponseMetdata added in v0.9.0

func (r *GetPublicAccessBlockResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the GetPublicAccessBlock request.

type JobDescriptor added in v0.9.0

type JobDescriptor struct {

	// Indicates whether confirmation is required before Amazon S3 begins running
	// the specified job. Confirmation is required only for jobs created through
	// the Amazon S3 console.
	ConfirmationRequired *bool `type:"boolean"`

	// A timestamp indicating when this job was created.
	CreationTime *time.Time `type:"timestamp"`

	// The description for this job, if one was provided in this job's Create Job
	// request.
	Description *string `min:"1" type:"string"`

	// If the specified job failed, this field contains information describing the
	// failure.
	FailureReasons []JobFailure `type:"list"`

	// The Amazon Resource Name (ARN) for this job.
	JobArn *string `min:"1" type:"string"`

	// The ID for the specified job.
	JobId *string `min:"5" type:"string"`

	// The configuration information for the specified job's manifest object.
	Manifest *JobManifest `type:"structure"`

	// The operation that the specified job is configured to execute on the objects
	// listed in the manifest.
	Operation *JobOperation `type:"structure"`

	// The priority of the specified job.
	Priority *int64 `type:"integer"`

	// Describes the total number of tasks that the specified job has executed,
	// the number of tasks that succeeded, and the number of tasks that failed.
	ProgressSummary *JobProgressSummary `type:"structure"`

	// Contains the configuration information for the job-completion report if you
	// requested one in the Create Job request.
	Report *JobReport `type:"structure"`

	// The Amazon Resource Name (ARN) for the Identity and Access Management (IAM)
	// Role assigned to execute the tasks for this job.
	RoleArn *string `min:"1" type:"string"`

	// The current status of the specified job.
	Status JobStatus `type:"string" enum:"true"`

	StatusUpdateReason *string `min:"1" type:"string"`

	// The reason why the specified job was suspended. A job is only suspended if
	// you create it through the Amazon S3 console. When you create the job, it
	// enters the Suspended state to await confirmation before running. After you
	// confirm the job, it automatically exits the Suspended state.
	SuspendedCause *string `min:"1" type:"string"`

	// The timestamp when this job was suspended, if it has been suspended.
	SuspendedDate *time.Time `type:"timestamp"`

	// A timestamp indicating when this job terminated. A job's termination date
	// is the date and time when it succeeded, failed, or was canceled.
	TerminationDate *time.Time `type:"timestamp"`
	// contains filtered or unexported fields
}

A container element for the job configuration and status information returned by a Describe Job request.

func (JobDescriptor) MarshalFields added in v0.9.0

func (s JobDescriptor) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobDescriptor) String added in v0.9.0

func (s JobDescriptor) String() string

String returns the string representation

type JobFailure added in v0.9.0

type JobFailure struct {

	// The failure code, if any, for the specified job.
	FailureCode *string `min:"1" type:"string"`

	// The failure reason, if any, for the specified job.
	FailureReason *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

If this job failed, this element indicates why the job failed.

func (JobFailure) MarshalFields added in v0.9.0

func (s JobFailure) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobFailure) String added in v0.9.0

func (s JobFailure) String() string

String returns the string representation

type JobListDescriptor added in v0.9.0

type JobListDescriptor struct {

	// A timestamp indicating when the specified job was created.
	CreationTime *time.Time `type:"timestamp"`

	// The user-specified description that was included in the specified job's Create
	// Job request.
	Description *string `min:"1" type:"string"`

	// The ID for the specified job.
	JobId *string `min:"5" type:"string"`

	// The operation that the specified job is configured to run on each object
	// listed in the manifest.
	Operation OperationName `type:"string" enum:"true"`

	// The current priority for the specified job.
	Priority *int64 `type:"integer"`

	// Describes the total number of tasks that the specified job has executed,
	// the number of tasks that succeeded, and the number of tasks that failed.
	ProgressSummary *JobProgressSummary `type:"structure"`

	// The specified job's current status.
	Status JobStatus `type:"string" enum:"true"`

	// A timestamp indicating when the specified job terminated. A job's termination
	// date is the date and time when it succeeded, failed, or was canceled.
	TerminationDate *time.Time `type:"timestamp"`
	// contains filtered or unexported fields
}

Contains the configuration and status information for a single job retrieved as part of a job list.

func (JobListDescriptor) MarshalFields added in v0.9.0

func (s JobListDescriptor) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobListDescriptor) String added in v0.9.0

func (s JobListDescriptor) String() string

String returns the string representation

type JobManifest added in v0.9.0

type JobManifest struct {

	// Contains the information required to locate the specified job's manifest.
	//
	// Location is a required field
	Location *JobManifestLocation `type:"structure" required:"true"`

	// Describes the format of the specified job's manifest. If the manifest is
	// in CSV format, also describes the columns contained within the manifest.
	//
	// Spec is a required field
	Spec *JobManifestSpec `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Contains the configuration information for a job's manifest.

func (JobManifest) MarshalFields added in v0.9.0

func (s JobManifest) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobManifest) String added in v0.9.0

func (s JobManifest) String() string

String returns the string representation

func (*JobManifest) Validate added in v0.9.0

func (s *JobManifest) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type JobManifestFieldName added in v0.9.0

type JobManifestFieldName string
const (
	JobManifestFieldNameIgnore    JobManifestFieldName = "Ignore"
	JobManifestFieldNameBucket    JobManifestFieldName = "Bucket"
	JobManifestFieldNameKey       JobManifestFieldName = "Key"
	JobManifestFieldNameVersionId JobManifestFieldName = "VersionId"
)

Enum values for JobManifestFieldName

func (JobManifestFieldName) MarshalValue added in v0.9.0

func (enum JobManifestFieldName) MarshalValue() (string, error)

func (JobManifestFieldName) MarshalValueBuf added in v0.9.0

func (enum JobManifestFieldName) MarshalValueBuf(b []byte) ([]byte, error)

type JobManifestFormat added in v0.9.0

type JobManifestFormat string
const (
	JobManifestFormatS3batchOperationsCsv20180820 JobManifestFormat = "S3BatchOperations_CSV_20180820"
	JobManifestFormatS3inventoryReportCsv20161130 JobManifestFormat = "S3InventoryReport_CSV_20161130"
)

Enum values for JobManifestFormat

func (JobManifestFormat) MarshalValue added in v0.9.0

func (enum JobManifestFormat) MarshalValue() (string, error)

func (JobManifestFormat) MarshalValueBuf added in v0.9.0

func (enum JobManifestFormat) MarshalValueBuf(b []byte) ([]byte, error)

type JobManifestLocation added in v0.9.0

type JobManifestLocation struct {

	// The ETag for the specified manifest object.
	//
	// ETag is a required field
	ETag *string `min:"1" type:"string" required:"true"`

	// The Amazon Resource Name (ARN) for a manifest object.
	//
	// ObjectArn is a required field
	ObjectArn *string `min:"1" type:"string" required:"true"`

	// The optional version ID to identify a specific version of the manifest object.
	ObjectVersionId *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Contains the information required to locate a manifest object.

func (JobManifestLocation) MarshalFields added in v0.9.0

func (s JobManifestLocation) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobManifestLocation) String added in v0.9.0

func (s JobManifestLocation) String() string

String returns the string representation

func (*JobManifestLocation) Validate added in v0.9.0

func (s *JobManifestLocation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type JobManifestSpec added in v0.9.0

type JobManifestSpec struct {

	// If the specified manifest object is in the S3BatchOperations_CSV_20180820
	// format, this element describes which columns contain the required data.
	Fields []JobManifestFieldName `type:"list"`

	// Indicates which of the available formats the specified manifest uses.
	//
	// Format is a required field
	Format JobManifestFormat `type:"string" required:"true" enum:"true"`
	// contains filtered or unexported fields
}

Describes the format of a manifest. If the manifest is in CSV format, also describes the columns contained within the manifest.

func (JobManifestSpec) MarshalFields added in v0.9.0

func (s JobManifestSpec) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobManifestSpec) String added in v0.9.0

func (s JobManifestSpec) String() string

String returns the string representation

func (*JobManifestSpec) Validate added in v0.9.0

func (s *JobManifestSpec) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type JobOperation added in v0.9.0

type JobOperation struct {

	// Directs the specified job to invoke an AWS Lambda function on each object
	// in the manifest.
	LambdaInvoke *LambdaInvokeOperation `type:"structure"`

	// Directs the specified job to execute an Initiate Glacier Restore call on
	// each object in the manifest.
	S3InitiateRestoreObject *S3InitiateRestoreObjectOperation `type:"structure"`

	// Directs the specified job to execute a PUT Object acl call on each object
	// in the manifest.
	S3PutObjectAcl *S3SetObjectAclOperation `type:"structure"`

	// Directs the specified job to execute a PUT Copy object call on each object
	// in the manifest.
	S3PutObjectCopy *S3CopyObjectOperation `type:"structure"`

	// Directs the specified job to execute a PUT Object tagging call on each object
	// in the manifest.
	S3PutObjectTagging *S3SetObjectTaggingOperation `type:"structure"`
	// contains filtered or unexported fields
}

The operation that you want this job to perform on each object listed in the manifest. For more information about the available operations, see Available Operations (https://docs.aws.amazon.com/AmazonS3/latest/dev/batch-ops-operations.html) in the Amazon Simple Storage Service Developer Guide.

func (JobOperation) MarshalFields added in v0.9.0

func (s JobOperation) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobOperation) String added in v0.9.0

func (s JobOperation) String() string

String returns the string representation

func (*JobOperation) Validate added in v0.9.0

func (s *JobOperation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type JobProgressSummary added in v0.9.0

type JobProgressSummary struct {
	NumberOfTasksFailed *int64 `type:"long"`

	NumberOfTasksSucceeded *int64 `type:"long"`

	TotalNumberOfTasks *int64 `type:"long"`
	// contains filtered or unexported fields
}

Describes the total number of tasks that the specified job has executed, the number of tasks that succeeded, and the number of tasks that failed.

func (JobProgressSummary) MarshalFields added in v0.9.0

func (s JobProgressSummary) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobProgressSummary) String added in v0.9.0

func (s JobProgressSummary) String() string

String returns the string representation

type JobReport added in v0.9.0

type JobReport struct {

	// The Amazon Resource Name (ARN) for the bucket where specified job-completion
	// report will be stored.
	Bucket *string `min:"1" type:"string"`

	// Indicates whether the specified job will generate a job-completion report.
	//
	// Enabled is a required field
	Enabled *bool `type:"boolean" required:"true"`

	// The format of the specified job-completion report.
	Format JobReportFormat `type:"string" enum:"true"`

	// An optional prefix to describe where in the specified bucket the job-completion
	// report will be stored. Amazon S3 will store the job-completion report at
	// <prefix>/job-<job-id>/report.json.
	Prefix *string `min:"1" type:"string"`

	// Indicates whether the job-completion report will include details of all tasks
	// or only failed tasks.
	ReportScope JobReportScope `type:"string" enum:"true"`
	// contains filtered or unexported fields
}

Contains the configuration parameters for a job-completion report.

func (JobReport) MarshalFields added in v0.9.0

func (s JobReport) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (JobReport) String added in v0.9.0

func (s JobReport) String() string

String returns the string representation

func (*JobReport) Validate added in v0.9.0

func (s *JobReport) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type JobReportFormat added in v0.9.0

type JobReportFormat string
const (
	JobReportFormatReportCsv20180820 JobReportFormat = "Report_CSV_20180820"
)

Enum values for JobReportFormat

func (JobReportFormat) MarshalValue added in v0.9.0

func (enum JobReportFormat) MarshalValue() (string, error)

func (JobReportFormat) MarshalValueBuf added in v0.9.0

func (enum JobReportFormat) MarshalValueBuf(b []byte) ([]byte, error)

type JobReportScope added in v0.9.0

type JobReportScope string
const (
	JobReportScopeAllTasks        JobReportScope = "AllTasks"
	JobReportScopeFailedTasksOnly JobReportScope = "FailedTasksOnly"
)

Enum values for JobReportScope

func (JobReportScope) MarshalValue added in v0.9.0

func (enum JobReportScope) MarshalValue() (string, error)

func (JobReportScope) MarshalValueBuf added in v0.9.0

func (enum JobReportScope) MarshalValueBuf(b []byte) ([]byte, error)

type JobStatus added in v0.9.0

type JobStatus string
const (
	JobStatusActive     JobStatus = "Active"
	JobStatusCancelled  JobStatus = "Cancelled"
	JobStatusCancelling JobStatus = "Cancelling"
	JobStatusComplete   JobStatus = "Complete"
	JobStatusCompleting JobStatus = "Completing"
	JobStatusFailed     JobStatus = "Failed"
	JobStatusFailing    JobStatus = "Failing"
	JobStatusNew        JobStatus = "New"
	JobStatusPaused     JobStatus = "Paused"
	JobStatusPausing    JobStatus = "Pausing"
	JobStatusPreparing  JobStatus = "Preparing"
	JobStatusReady      JobStatus = "Ready"
	JobStatusSuspended  JobStatus = "Suspended"
)

Enum values for JobStatus

func (JobStatus) MarshalValue added in v0.9.0

func (enum JobStatus) MarshalValue() (string, error)

func (JobStatus) MarshalValueBuf added in v0.9.0

func (enum JobStatus) MarshalValueBuf(b []byte) ([]byte, error)

type LambdaInvokeOperation added in v0.9.0

type LambdaInvokeOperation struct {

	// The Amazon Resource Name (ARN) for the AWS Lambda function that the specified
	// job will invoke for each object in the manifest.
	FunctionArn *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Contains the configuration parameters for a Lambda Invoke operation.

func (LambdaInvokeOperation) MarshalFields added in v0.9.0

func (s LambdaInvokeOperation) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (LambdaInvokeOperation) String added in v0.9.0

func (s LambdaInvokeOperation) String() string

String returns the string representation

func (*LambdaInvokeOperation) Validate added in v0.9.0

func (s *LambdaInvokeOperation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListAccessPointsInput added in v0.18.0

type ListAccessPointsInput struct {

	// The AWS account ID for owner of the bucket whose access points you want to
	// list.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the bucket whose associated access points you want to list.
	Bucket *string `location:"querystring" locationName:"bucket" min:"3" type:"string"`

	// The maximum number of access points that you want to include in the list.
	// If the specified bucket has more than this number of access points, then
	// the response will include a continuation token in the NextToken field that
	// you can use to retrieve the next page of access points.
	MaxResults *int64 `location:"querystring" locationName:"maxResults" min:"1" type:"integer"`

	// A continuation token. If a previous call to ListAccessPoints returned a continuation
	// token in the NextToken field, then providing that value here causes Amazon
	// S3 to retrieve the next page of results.
	NextToken *string `location:"querystring" locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (ListAccessPointsInput) MarshalFields added in v0.18.0

func (s ListAccessPointsInput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (ListAccessPointsInput) String added in v0.18.0

func (s ListAccessPointsInput) String() string

String returns the string representation

func (*ListAccessPointsInput) Validate added in v0.18.0

func (s *ListAccessPointsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListAccessPointsOutput added in v0.18.0

type ListAccessPointsOutput struct {

	// Contains identification and configuration information for one or more access
	// points associated with the specified bucket.
	AccessPointList []AccessPoint `locationNameList:"AccessPoint" type:"list"`

	// If the specified bucket has more access points than can be returned in one
	// call to this API, then this field contains a continuation token that you
	// can provide in subsequent calls to this API to retrieve additional access
	// points.
	NextToken *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (ListAccessPointsOutput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (ListAccessPointsOutput) String added in v0.18.0

func (s ListAccessPointsOutput) String() string

String returns the string representation

type ListAccessPointsPaginator added in v0.18.0

type ListAccessPointsPaginator struct {
	aws.Pager
}

ListAccessPointsPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.

func NewListAccessPointsPaginator added in v0.18.0

func NewListAccessPointsPaginator(req ListAccessPointsRequest) ListAccessPointsPaginator

NewListAccessPointsRequestPaginator returns a paginator for ListAccessPoints. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.

Note: This operation can generate multiple requests to a service.

// Example iterating over pages.
req := client.ListAccessPointsRequest(input)
p := s3control.NewListAccessPointsRequestPaginator(req)

for p.Next(context.TODO()) {
    page := p.CurrentPage()
}

if err := p.Err(); err != nil {
    return err
}

func (*ListAccessPointsPaginator) CurrentPage added in v0.18.0

type ListAccessPointsRequest added in v0.18.0

type ListAccessPointsRequest struct {
	*aws.Request
	Input *ListAccessPointsInput
	Copy  func(*ListAccessPointsInput) ListAccessPointsRequest
}

ListAccessPointsRequest is the request type for the ListAccessPoints API operation.

func (ListAccessPointsRequest) Send added in v0.18.0

Send marshals and sends the ListAccessPoints API request.

type ListAccessPointsResponse added in v0.18.0

type ListAccessPointsResponse struct {
	*ListAccessPointsOutput
	// contains filtered or unexported fields
}

ListAccessPointsResponse is the response type for the ListAccessPoints API operation.

func (*ListAccessPointsResponse) SDKResponseMetdata added in v0.18.0

func (r *ListAccessPointsResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the ListAccessPoints request.

type ListJobsInput added in v0.9.0

type ListJobsInput struct {

	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The List Jobs request returns jobs that match the statuses listed in this
	// element.
	JobStatuses []JobStatus `location:"querystring" locationName:"jobStatuses" type:"list"`

	// The maximum number of jobs that Amazon S3 will include in the List Jobs response.
	// If there are more jobs than this number, the response will include a pagination
	// token in the NextToken field to enable you to retrieve the next page of results.
	MaxResults *int64 `location:"querystring" locationName:"maxResults" min:"1" type:"integer"`

	// A pagination token to request the next page of results. Use the token that
	// Amazon S3 returned in the NextToken element of the ListJobsResult from the
	// previous List Jobs request.
	NextToken *string `location:"querystring" locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (ListJobsInput) MarshalFields added in v0.9.0

func (s ListJobsInput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (ListJobsInput) String added in v0.9.0

func (s ListJobsInput) String() string

String returns the string representation

func (*ListJobsInput) Validate added in v0.9.0

func (s *ListJobsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListJobsOutput added in v0.9.0

type ListJobsOutput struct {

	// The list of current jobs and jobs that have ended within the last 30 days.
	Jobs []JobListDescriptor `type:"list"`

	// If the List Jobs request produced more than the maximum number of results,
	// you can pass this value into a subsequent List Jobs request in order to retrieve
	// the next page of results.
	NextToken *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (ListJobsOutput) MarshalFields added in v0.9.0

func (s ListJobsOutput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (ListJobsOutput) String added in v0.9.0

func (s ListJobsOutput) String() string

String returns the string representation

type ListJobsPaginator added in v0.9.0

type ListJobsPaginator struct {
	aws.Pager
}

ListJobsPaginator is used to paginate the request. This can be done by calling Next and CurrentPage.

func NewListJobsPaginator added in v0.9.0

func NewListJobsPaginator(req ListJobsRequest) ListJobsPaginator

NewListJobsRequestPaginator returns a paginator for ListJobs. Use Next method to get the next page, and CurrentPage to get the current response page from the paginator. Next will return false, if there are no more pages, or an error was encountered.

Note: This operation can generate multiple requests to a service.

// Example iterating over pages.
req := client.ListJobsRequest(input)
p := s3control.NewListJobsRequestPaginator(req)

for p.Next(context.TODO()) {
    page := p.CurrentPage()
}

if err := p.Err(); err != nil {
    return err
}

func (*ListJobsPaginator) CurrentPage added in v0.9.0

func (p *ListJobsPaginator) CurrentPage() *ListJobsOutput

type ListJobsRequest added in v0.9.0

type ListJobsRequest struct {
	*aws.Request
	Input *ListJobsInput
	Copy  func(*ListJobsInput) ListJobsRequest
}

ListJobsRequest is the request type for the ListJobs API operation.

func (ListJobsRequest) Send added in v0.9.0

Send marshals and sends the ListJobs API request.

type ListJobsResponse added in v0.9.0

type ListJobsResponse struct {
	*ListJobsOutput
	// contains filtered or unexported fields
}

ListJobsResponse is the response type for the ListJobs API operation.

func (*ListJobsResponse) SDKResponseMetdata added in v0.9.0

func (r *ListJobsResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the ListJobs request.

type NetworkOrigin added in v0.18.0

type NetworkOrigin string
const (
	NetworkOriginInternet NetworkOrigin = "Internet"
	NetworkOriginVpc      NetworkOrigin = "VPC"
)

Enum values for NetworkOrigin

func (NetworkOrigin) MarshalValue added in v0.18.0

func (enum NetworkOrigin) MarshalValue() (string, error)

func (NetworkOrigin) MarshalValueBuf added in v0.18.0

func (enum NetworkOrigin) MarshalValueBuf(b []byte) ([]byte, error)

type OperationName added in v0.9.0

type OperationName string
const (
	OperationNameLambdaInvoke            OperationName = "LambdaInvoke"
	OperationNameS3putObjectCopy         OperationName = "S3PutObjectCopy"
	OperationNameS3putObjectAcl          OperationName = "S3PutObjectAcl"
	OperationNameS3putObjectTagging      OperationName = "S3PutObjectTagging"
	OperationNameS3initiateRestoreObject OperationName = "S3InitiateRestoreObject"
)

Enum values for OperationName

func (OperationName) MarshalValue added in v0.9.0

func (enum OperationName) MarshalValue() (string, error)

func (OperationName) MarshalValueBuf added in v0.9.0

func (enum OperationName) MarshalValueBuf(b []byte) ([]byte, error)

type PolicyStatus added in v0.18.0

type PolicyStatus struct {
	IsPublic *bool `locationName:"IsPublic" type:"boolean"`
	// contains filtered or unexported fields
}

Indicates whether this access point policy is public. For more information about how Amazon S3 evaluates policies to determine whether they are public, see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status) in the Amazon Simple Storage Service Developer Guide.

func (PolicyStatus) MarshalFields added in v0.18.0

func (s PolicyStatus) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (PolicyStatus) String added in v0.18.0

func (s PolicyStatus) String() string

String returns the string representation

type PublicAccessBlockConfiguration

type PublicAccessBlockConfiguration struct {

	// Specifies whether Amazon S3 should block public access control lists (ACLs)
	// for buckets in this account. Setting this element to TRUE causes the following
	// behavior:
	//
	//    * PUT Bucket acl and PUT Object acl calls fail if the specified ACL is
	//    public.
	//
	//    * PUT Object calls fail if the request includes a public ACL.
	//
	//    * PUT Bucket calls fail if the request includes a public ACL.
	//
	// Enabling this setting doesn't affect existing policies or ACLs.
	BlockPublicAcls *bool `locationName:"BlockPublicAcls" type:"boolean"`

	// Specifies whether Amazon S3 should block public bucket policies for buckets
	// in this account. Setting this element to TRUE causes Amazon S3 to reject
	// calls to PUT Bucket policy if the specified bucket policy allows public access.
	//
	// Enabling this setting doesn't affect existing bucket policies.
	BlockPublicPolicy *bool `locationName:"BlockPublicPolicy" type:"boolean"`

	// Specifies whether Amazon S3 should ignore public ACLs for buckets in this
	// account. Setting this element to TRUE causes Amazon S3 to ignore all public
	// ACLs on buckets in this account and any objects that they contain.
	//
	// Enabling this setting doesn't affect the persistence of any existing ACLs
	// and doesn't prevent new public ACLs from being set.
	IgnorePublicAcls *bool `locationName:"IgnorePublicAcls" type:"boolean"`

	// Specifies whether Amazon S3 should restrict public bucket policies for buckets
	// in this account. Setting this element to TRUE restricts access to buckets
	// with public policies to only AWS services and authorized users within this
	// account.
	//
	// Enabling this setting doesn't affect previously stored bucket policies, except
	// that public and cross-account access within any public bucket policy, including
	// non-public delegation to specific accounts, is blocked.
	RestrictPublicBuckets *bool `locationName:"RestrictPublicBuckets" type:"boolean"`
	// contains filtered or unexported fields
}

The PublicAccessBlock configuration that you want to apply to this Amazon S3 bucket. You can enable the configuration options in any combination. For more information about when Amazon S3 considers a bucket or object public, see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status) in the Amazon Simple Storage Service Developer Guide.

func (PublicAccessBlockConfiguration) MarshalFields

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (PublicAccessBlockConfiguration) String

String returns the string representation

type PutAccessPointPolicyInput added in v0.18.0

type PutAccessPointPolicyInput struct {

	// The AWS account ID for owner of the bucket associated with the specified
	// access point.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The name of the access point that you want to associate with the specified
	// policy.
	//
	// Name is a required field
	Name *string `location:"uri" locationName:"name" min:"3" type:"string" required:"true"`

	// The policy that you want to apply to the specified access point. For more
	// information about access point policies, see Managing Data Access with Amazon
	// S3 Access Points (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html)
	// in the Amazon Simple Storage Service Developer Guide.
	//
	// Policy is a required field
	Policy *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutAccessPointPolicyInput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (PutAccessPointPolicyInput) String added in v0.18.0

func (s PutAccessPointPolicyInput) String() string

String returns the string representation

func (*PutAccessPointPolicyInput) Validate added in v0.18.0

func (s *PutAccessPointPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutAccessPointPolicyOutput added in v0.18.0

type PutAccessPointPolicyOutput struct {
	// contains filtered or unexported fields
}

func (PutAccessPointPolicyOutput) MarshalFields added in v0.18.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (PutAccessPointPolicyOutput) String added in v0.18.0

String returns the string representation

type PutAccessPointPolicyRequest added in v0.18.0

type PutAccessPointPolicyRequest struct {
	*aws.Request
	Input *PutAccessPointPolicyInput
	Copy  func(*PutAccessPointPolicyInput) PutAccessPointPolicyRequest
}

PutAccessPointPolicyRequest is the request type for the PutAccessPointPolicy API operation.

func (PutAccessPointPolicyRequest) Send added in v0.18.0

Send marshals and sends the PutAccessPointPolicy API request.

type PutAccessPointPolicyResponse added in v0.18.0

type PutAccessPointPolicyResponse struct {
	*PutAccessPointPolicyOutput
	// contains filtered or unexported fields
}

PutAccessPointPolicyResponse is the response type for the PutAccessPointPolicy API operation.

func (*PutAccessPointPolicyResponse) SDKResponseMetdata added in v0.18.0

func (r *PutAccessPointPolicyResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the PutAccessPointPolicy request.

type PutPublicAccessBlockInput

type PutPublicAccessBlockInput struct {

	// The account ID for the Amazon Web Services account whose PublicAccessBlock
	// configuration you want to set.
	//
	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The PublicAccessBlock configuration that you want to apply to the specified
	// Amazon Web Services account.
	//
	// PublicAccessBlockConfiguration is a required field
	PublicAccessBlockConfiguration *PublicAccessBlockConfiguration `` /* 137-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (PutPublicAccessBlockInput) MarshalFields

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (PutPublicAccessBlockInput) String

func (s PutPublicAccessBlockInput) String() string

String returns the string representation

func (*PutPublicAccessBlockInput) Validate

func (s *PutPublicAccessBlockInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutPublicAccessBlockOutput

type PutPublicAccessBlockOutput struct {
	// contains filtered or unexported fields
}

func (PutPublicAccessBlockOutput) MarshalFields

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (PutPublicAccessBlockOutput) String

String returns the string representation

type PutPublicAccessBlockRequest

type PutPublicAccessBlockRequest struct {
	*aws.Request
	Input *PutPublicAccessBlockInput
	Copy  func(*PutPublicAccessBlockInput) PutPublicAccessBlockRequest
}

PutPublicAccessBlockRequest is the request type for the PutPublicAccessBlock API operation.

func (PutPublicAccessBlockRequest) Send

Send marshals and sends the PutPublicAccessBlock API request.

type PutPublicAccessBlockResponse added in v0.9.0

type PutPublicAccessBlockResponse struct {
	*PutPublicAccessBlockOutput
	// contains filtered or unexported fields
}

PutPublicAccessBlockResponse is the response type for the PutPublicAccessBlock API operation.

func (*PutPublicAccessBlockResponse) SDKResponseMetdata added in v0.9.0

func (r *PutPublicAccessBlockResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the PutPublicAccessBlock request.

type RequestedJobStatus added in v0.9.0

type RequestedJobStatus string
const (
	RequestedJobStatusCancelled RequestedJobStatus = "Cancelled"
	RequestedJobStatusReady     RequestedJobStatus = "Ready"
)

Enum values for RequestedJobStatus

func (RequestedJobStatus) MarshalValue added in v0.9.0

func (enum RequestedJobStatus) MarshalValue() (string, error)

func (RequestedJobStatus) MarshalValueBuf added in v0.9.0

func (enum RequestedJobStatus) MarshalValueBuf(b []byte) ([]byte, error)

type S3AccessControlList added in v0.9.0

type S3AccessControlList struct {
	Grants []S3Grant `type:"list"`

	// Owner is a required field
	Owner *S3ObjectOwner `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (S3AccessControlList) MarshalFields added in v0.9.0

func (s S3AccessControlList) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3AccessControlList) String added in v0.9.0

func (s S3AccessControlList) String() string

String returns the string representation

func (*S3AccessControlList) Validate added in v0.9.0

func (s *S3AccessControlList) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3AccessControlPolicy added in v0.9.0

type S3AccessControlPolicy struct {
	AccessControlList *S3AccessControlList `type:"structure"`

	CannedAccessControlList S3CannedAccessControlList `type:"string" enum:"true"`
	// contains filtered or unexported fields
}

func (S3AccessControlPolicy) MarshalFields added in v0.9.0

func (s S3AccessControlPolicy) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3AccessControlPolicy) String added in v0.9.0

func (s S3AccessControlPolicy) String() string

String returns the string representation

func (*S3AccessControlPolicy) Validate added in v0.9.0

func (s *S3AccessControlPolicy) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3CannedAccessControlList added in v0.9.0

type S3CannedAccessControlList string
const (
	S3CannedAccessControlListPrivate                S3CannedAccessControlList = "private"
	S3CannedAccessControlListPublicRead             S3CannedAccessControlList = "public-read"
	S3CannedAccessControlListPublicReadWrite        S3CannedAccessControlList = "public-read-write"
	S3CannedAccessControlListAwsExecRead            S3CannedAccessControlList = "aws-exec-read"
	S3CannedAccessControlListAuthenticatedRead      S3CannedAccessControlList = "authenticated-read"
	S3CannedAccessControlListBucketOwnerRead        S3CannedAccessControlList = "bucket-owner-read"
	S3CannedAccessControlListBucketOwnerFullControl S3CannedAccessControlList = "bucket-owner-full-control"
)

Enum values for S3CannedAccessControlList

func (S3CannedAccessControlList) MarshalValue added in v0.9.0

func (enum S3CannedAccessControlList) MarshalValue() (string, error)

func (S3CannedAccessControlList) MarshalValueBuf added in v0.9.0

func (enum S3CannedAccessControlList) MarshalValueBuf(b []byte) ([]byte, error)

type S3CopyObjectOperation added in v0.9.0

type S3CopyObjectOperation struct {
	AccessControlGrants []S3Grant `type:"list"`

	CannedAccessControlList S3CannedAccessControlList `type:"string" enum:"true"`

	MetadataDirective S3MetadataDirective `type:"string" enum:"true"`

	ModifiedSinceConstraint *time.Time `type:"timestamp"`

	NewObjectMetadata *S3ObjectMetadata `type:"structure"`

	NewObjectTagging []S3Tag `type:"list"`

	ObjectLockLegalHoldStatus S3ObjectLockLegalHoldStatus `type:"string" enum:"true"`

	ObjectLockMode S3ObjectLockMode `type:"string" enum:"true"`

	ObjectLockRetainUntilDate *time.Time `type:"timestamp"`

	RedirectLocation *string `min:"1" type:"string"`

	RequesterPays *bool `type:"boolean"`

	SSEAwsKmsKeyId *string `min:"1" type:"string"`

	StorageClass S3StorageClass `type:"string" enum:"true"`

	TargetKeyPrefix *string `min:"1" type:"string"`

	TargetResource *string `min:"1" type:"string"`

	UnModifiedSinceConstraint *time.Time `type:"timestamp"`
	// contains filtered or unexported fields
}

Contains the configuration parameters for a PUT Copy object operation. Amazon S3 batch operations passes each value through to the underlying PUT Copy object API. For more information about the parameters for this operation, see PUT Object - Copy (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectCOPY.html).

func (S3CopyObjectOperation) MarshalFields added in v0.9.0

func (s S3CopyObjectOperation) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3CopyObjectOperation) String added in v0.9.0

func (s S3CopyObjectOperation) String() string

String returns the string representation

func (*S3CopyObjectOperation) Validate added in v0.9.0

func (s *S3CopyObjectOperation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3GlacierJobTier added in v0.9.0

type S3GlacierJobTier string
const (
	S3GlacierJobTierBulk     S3GlacierJobTier = "BULK"
	S3GlacierJobTierStandard S3GlacierJobTier = "STANDARD"
)

Enum values for S3GlacierJobTier

func (S3GlacierJobTier) MarshalValue added in v0.9.0

func (enum S3GlacierJobTier) MarshalValue() (string, error)

func (S3GlacierJobTier) MarshalValueBuf added in v0.9.0

func (enum S3GlacierJobTier) MarshalValueBuf(b []byte) ([]byte, error)

type S3Grant added in v0.9.0

type S3Grant struct {
	Grantee *S3Grantee `type:"structure"`

	Permission S3Permission `type:"string" enum:"true"`
	// contains filtered or unexported fields
}

func (S3Grant) MarshalFields added in v0.9.0

func (s S3Grant) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3Grant) String added in v0.9.0

func (s S3Grant) String() string

String returns the string representation

func (*S3Grant) Validate added in v0.9.0

func (s *S3Grant) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3Grantee added in v0.9.0

type S3Grantee struct {
	DisplayName *string `min:"1" type:"string"`

	Identifier *string `min:"1" type:"string"`

	TypeIdentifier S3GranteeTypeIdentifier `type:"string" enum:"true"`
	// contains filtered or unexported fields
}

func (S3Grantee) MarshalFields added in v0.9.0

func (s S3Grantee) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3Grantee) String added in v0.9.0

func (s S3Grantee) String() string

String returns the string representation

func (*S3Grantee) Validate added in v0.9.0

func (s *S3Grantee) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3GranteeTypeIdentifier added in v0.9.0

type S3GranteeTypeIdentifier string
const (
	S3GranteeTypeIdentifierId           S3GranteeTypeIdentifier = "id"
	S3GranteeTypeIdentifierEmailAddress S3GranteeTypeIdentifier = "emailAddress"
	S3GranteeTypeIdentifierUri          S3GranteeTypeIdentifier = "uri"
)

Enum values for S3GranteeTypeIdentifier

func (S3GranteeTypeIdentifier) MarshalValue added in v0.9.0

func (enum S3GranteeTypeIdentifier) MarshalValue() (string, error)

func (S3GranteeTypeIdentifier) MarshalValueBuf added in v0.9.0

func (enum S3GranteeTypeIdentifier) MarshalValueBuf(b []byte) ([]byte, error)

type S3InitiateRestoreObjectOperation added in v0.9.0

type S3InitiateRestoreObjectOperation struct {
	ExpirationInDays *int64 `type:"integer"`

	GlacierJobTier S3GlacierJobTier `type:"string" enum:"true"`
	// contains filtered or unexported fields
}

Contains the configuration parameters for an Initiate Glacier Restore job. Amazon S3 batch operations passes each value through to the underlying POST Object restore API. For more information about the parameters for this operation, see Restoring Archives (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html#RESTObjectPOSTrestore-restore-request).

func (S3InitiateRestoreObjectOperation) MarshalFields added in v0.9.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3InitiateRestoreObjectOperation) String added in v0.9.0

String returns the string representation

type S3MetadataDirective added in v0.9.0

type S3MetadataDirective string
const (
	S3MetadataDirectiveCopy    S3MetadataDirective = "COPY"
	S3MetadataDirectiveReplace S3MetadataDirective = "REPLACE"
)

Enum values for S3MetadataDirective

func (S3MetadataDirective) MarshalValue added in v0.9.0

func (enum S3MetadataDirective) MarshalValue() (string, error)

func (S3MetadataDirective) MarshalValueBuf added in v0.9.0

func (enum S3MetadataDirective) MarshalValueBuf(b []byte) ([]byte, error)

type S3ObjectLockLegalHoldStatus added in v0.9.0

type S3ObjectLockLegalHoldStatus string
const (
	S3ObjectLockLegalHoldStatusOff S3ObjectLockLegalHoldStatus = "OFF"
	S3ObjectLockLegalHoldStatusOn  S3ObjectLockLegalHoldStatus = "ON"
)

Enum values for S3ObjectLockLegalHoldStatus

func (S3ObjectLockLegalHoldStatus) MarshalValue added in v0.9.0

func (enum S3ObjectLockLegalHoldStatus) MarshalValue() (string, error)

func (S3ObjectLockLegalHoldStatus) MarshalValueBuf added in v0.9.0

func (enum S3ObjectLockLegalHoldStatus) MarshalValueBuf(b []byte) ([]byte, error)

type S3ObjectLockMode added in v0.9.0

type S3ObjectLockMode string
const (
	S3ObjectLockModeCompliance S3ObjectLockMode = "COMPLIANCE"
	S3ObjectLockModeGovernance S3ObjectLockMode = "GOVERNANCE"
)

Enum values for S3ObjectLockMode

func (S3ObjectLockMode) MarshalValue added in v0.9.0

func (enum S3ObjectLockMode) MarshalValue() (string, error)

func (S3ObjectLockMode) MarshalValueBuf added in v0.9.0

func (enum S3ObjectLockMode) MarshalValueBuf(b []byte) ([]byte, error)

type S3ObjectMetadata added in v0.9.0

type S3ObjectMetadata struct {
	CacheControl *string `min:"1" type:"string"`

	ContentDisposition *string `min:"1" type:"string"`

	ContentEncoding *string `min:"1" type:"string"`

	ContentLanguage *string `min:"1" type:"string"`

	ContentLength *int64 `type:"long"`

	ContentMD5 *string `min:"1" type:"string"`

	ContentType *string `min:"1" type:"string"`

	HttpExpiresDate *time.Time `type:"timestamp"`

	RequesterCharged *bool `type:"boolean"`

	SSEAlgorithm S3SSEAlgorithm `type:"string" enum:"true"`

	UserMetadata map[string]string `type:"map"`
	// contains filtered or unexported fields
}

func (S3ObjectMetadata) MarshalFields added in v0.9.0

func (s S3ObjectMetadata) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3ObjectMetadata) String added in v0.9.0

func (s S3ObjectMetadata) String() string

String returns the string representation

func (*S3ObjectMetadata) Validate added in v0.9.0

func (s *S3ObjectMetadata) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3ObjectOwner added in v0.9.0

type S3ObjectOwner struct {
	DisplayName *string `min:"1" type:"string"`

	ID *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (S3ObjectOwner) MarshalFields added in v0.9.0

func (s S3ObjectOwner) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3ObjectOwner) String added in v0.9.0

func (s S3ObjectOwner) String() string

String returns the string representation

func (*S3ObjectOwner) Validate added in v0.9.0

func (s *S3ObjectOwner) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3Permission added in v0.9.0

type S3Permission string
const (
	S3PermissionFullControl S3Permission = "FULL_CONTROL"
	S3PermissionRead        S3Permission = "READ"
	S3PermissionWrite       S3Permission = "WRITE"
	S3PermissionReadAcp     S3Permission = "READ_ACP"
	S3PermissionWriteAcp    S3Permission = "WRITE_ACP"
)

Enum values for S3Permission

func (S3Permission) MarshalValue added in v0.9.0

func (enum S3Permission) MarshalValue() (string, error)

func (S3Permission) MarshalValueBuf added in v0.9.0

func (enum S3Permission) MarshalValueBuf(b []byte) ([]byte, error)

type S3SSEAlgorithm added in v0.9.0

type S3SSEAlgorithm string
const (
	S3SSEAlgorithmAes256 S3SSEAlgorithm = "AES256"
	S3SSEAlgorithmKms    S3SSEAlgorithm = "KMS"
)

Enum values for S3SSEAlgorithm

func (S3SSEAlgorithm) MarshalValue added in v0.9.0

func (enum S3SSEAlgorithm) MarshalValue() (string, error)

func (S3SSEAlgorithm) MarshalValueBuf added in v0.9.0

func (enum S3SSEAlgorithm) MarshalValueBuf(b []byte) ([]byte, error)

type S3SetObjectAclOperation added in v0.9.0

type S3SetObjectAclOperation struct {
	AccessControlPolicy *S3AccessControlPolicy `type:"structure"`
	// contains filtered or unexported fields
}

Contains the configuration parameters for a Set Object ACL operation. Amazon S3 batch operations passes each value through to the underlying PUT Object acl API. For more information about the parameters for this operation, see PUT Object acl (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTacl.html).

func (S3SetObjectAclOperation) MarshalFields added in v0.9.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3SetObjectAclOperation) String added in v0.9.0

func (s S3SetObjectAclOperation) String() string

String returns the string representation

func (*S3SetObjectAclOperation) Validate added in v0.9.0

func (s *S3SetObjectAclOperation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3SetObjectTaggingOperation added in v0.9.0

type S3SetObjectTaggingOperation struct {
	TagSet []S3Tag `type:"list"`
	// contains filtered or unexported fields
}

Contains the configuration parameters for a Set Object Tagging operation. Amazon S3 batch operations passes each value through to the underlying PUT Object tagging API. For more information about the parameters for this operation, see PUT Object tagging (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTtagging.html).

func (S3SetObjectTaggingOperation) MarshalFields added in v0.9.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3SetObjectTaggingOperation) String added in v0.9.0

String returns the string representation

func (*S3SetObjectTaggingOperation) Validate added in v0.9.0

func (s *S3SetObjectTaggingOperation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3StorageClass added in v0.9.0

type S3StorageClass string
const (
	S3StorageClassStandard           S3StorageClass = "STANDARD"
	S3StorageClassStandardIa         S3StorageClass = "STANDARD_IA"
	S3StorageClassOnezoneIa          S3StorageClass = "ONEZONE_IA"
	S3StorageClassGlacier            S3StorageClass = "GLACIER"
	S3StorageClassIntelligentTiering S3StorageClass = "INTELLIGENT_TIERING"
	S3StorageClassDeepArchive        S3StorageClass = "DEEP_ARCHIVE"
)

Enum values for S3StorageClass

func (S3StorageClass) MarshalValue added in v0.9.0

func (enum S3StorageClass) MarshalValue() (string, error)

func (S3StorageClass) MarshalValueBuf added in v0.9.0

func (enum S3StorageClass) MarshalValueBuf(b []byte) ([]byte, error)

type S3Tag added in v0.9.0

type S3Tag struct {

	// Key is a required field
	Key *string `min:"1" type:"string" required:"true"`

	// Value is a required field
	Value *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (S3Tag) MarshalFields added in v0.9.0

func (s S3Tag) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (S3Tag) String added in v0.9.0

func (s S3Tag) String() string

String returns the string representation

func (*S3Tag) Validate added in v0.9.0

func (s *S3Tag) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateJobPriorityInput added in v0.9.0

type UpdateJobPriorityInput struct {

	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The ID for the job whose priority you want to update.
	//
	// JobId is a required field
	JobId *string `location:"uri" locationName:"id" min:"5" type:"string" required:"true"`

	// The priority you want to assign to this job.
	//
	// Priority is a required field
	Priority *int64 `location:"querystring" locationName:"priority" type:"integer" required:"true"`
	// contains filtered or unexported fields
}

func (UpdateJobPriorityInput) MarshalFields added in v0.9.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (UpdateJobPriorityInput) String added in v0.9.0

func (s UpdateJobPriorityInput) String() string

String returns the string representation

func (*UpdateJobPriorityInput) Validate added in v0.9.0

func (s *UpdateJobPriorityInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateJobPriorityOutput added in v0.9.0

type UpdateJobPriorityOutput struct {

	// The ID for the job whose priority Amazon S3 updated.
	//
	// JobId is a required field
	JobId *string `min:"5" type:"string" required:"true"`

	// The new priority assigned to the specified job.
	//
	// Priority is a required field
	Priority *int64 `type:"integer" required:"true"`
	// contains filtered or unexported fields
}

func (UpdateJobPriorityOutput) MarshalFields added in v0.9.0

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (UpdateJobPriorityOutput) String added in v0.9.0

func (s UpdateJobPriorityOutput) String() string

String returns the string representation

type UpdateJobPriorityRequest added in v0.9.0

type UpdateJobPriorityRequest struct {
	*aws.Request
	Input *UpdateJobPriorityInput
	Copy  func(*UpdateJobPriorityInput) UpdateJobPriorityRequest
}

UpdateJobPriorityRequest is the request type for the UpdateJobPriority API operation.

func (UpdateJobPriorityRequest) Send added in v0.9.0

Send marshals and sends the UpdateJobPriority API request.

type UpdateJobPriorityResponse added in v0.9.0

type UpdateJobPriorityResponse struct {
	*UpdateJobPriorityOutput
	// contains filtered or unexported fields
}

UpdateJobPriorityResponse is the response type for the UpdateJobPriority API operation.

func (*UpdateJobPriorityResponse) SDKResponseMetdata added in v0.9.0

func (r *UpdateJobPriorityResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the UpdateJobPriority request.

type UpdateJobStatusInput added in v0.9.0

type UpdateJobStatusInput struct {

	// AccountId is a required field
	AccountId *string `location:"header" locationName:"x-amz-account-id" type:"string" required:"true"`

	// The ID of the job whose status you want to update.
	//
	// JobId is a required field
	JobId *string `location:"uri" locationName:"id" min:"5" type:"string" required:"true"`

	// The status that you want to move the specified job to.
	//
	// RequestedJobStatus is a required field
	RequestedJobStatus RequestedJobStatus `location:"querystring" locationName:"requestedJobStatus" type:"string" required:"true" enum:"true"`

	// A description of the reason why you want to change the specified job's status.
	// This field can be any string up to the maximum length.
	StatusUpdateReason *string `location:"querystring" locationName:"statusUpdateReason" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (UpdateJobStatusInput) MarshalFields added in v0.9.0

func (s UpdateJobStatusInput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (UpdateJobStatusInput) String added in v0.9.0

func (s UpdateJobStatusInput) String() string

String returns the string representation

func (*UpdateJobStatusInput) Validate added in v0.9.0

func (s *UpdateJobStatusInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateJobStatusOutput added in v0.9.0

type UpdateJobStatusOutput struct {

	// The ID for the job whose status was updated.
	JobId *string `min:"5" type:"string"`

	// The current status for the specified job.
	Status JobStatus `type:"string" enum:"true"`

	// The reason that the specified job's status was updated.
	StatusUpdateReason *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (UpdateJobStatusOutput) MarshalFields added in v0.9.0

func (s UpdateJobStatusOutput) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (UpdateJobStatusOutput) String added in v0.9.0

func (s UpdateJobStatusOutput) String() string

String returns the string representation

type UpdateJobStatusRequest added in v0.9.0

type UpdateJobStatusRequest struct {
	*aws.Request
	Input *UpdateJobStatusInput
	Copy  func(*UpdateJobStatusInput) UpdateJobStatusRequest
}

UpdateJobStatusRequest is the request type for the UpdateJobStatus API operation.

func (UpdateJobStatusRequest) Send added in v0.9.0

Send marshals and sends the UpdateJobStatus API request.

type UpdateJobStatusResponse added in v0.9.0

type UpdateJobStatusResponse struct {
	*UpdateJobStatusOutput
	// contains filtered or unexported fields
}

UpdateJobStatusResponse is the response type for the UpdateJobStatus API operation.

func (*UpdateJobStatusResponse) SDKResponseMetdata added in v0.9.0

func (r *UpdateJobStatusResponse) SDKResponseMetdata() *aws.Response

SDKResponseMetdata returns the response metadata for the UpdateJobStatus request.

type VpcConfiguration added in v0.18.0

type VpcConfiguration struct {

	// If this field is specified, this access point will only allow connections
	// from the specified VPC ID.
	//
	// VpcId is a required field
	VpcId *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

The Virtual Private Cloud (VPC) configuration for an access point.

func (VpcConfiguration) MarshalFields added in v0.18.0

func (s VpcConfiguration) MarshalFields(e protocol.FieldEncoder) error

MarshalFields encodes the AWS API shape using the passed in protocol encoder.

func (VpcConfiguration) String added in v0.18.0

func (s VpcConfiguration) String() string

String returns the string representation

func (*VpcConfiguration) Validate added in v0.18.0

func (s *VpcConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

Directories

Path Synopsis
Package s3controliface provides an interface to enable mocking the AWS S3 Control service client for testing your code.
Package s3controliface provides an interface to enable mocking the AWS S3 Control service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL