AWS SDK Version 4 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Specifies a cross-origin access rule for an Amazon S3 bucket.

Inheritance Hierarchy

System.Object
  Amazon.S3.Model.CORSRule

Namespace: Amazon.S3.Model
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z

Syntax

C#
public class CORSRule

The CORSRule type exposes the following members

Constructors

NameDescription
Public Method CORSRule()

Properties

NameTypeDescription
Public Property AllowedHeaders System.Collections.Generic.List<System.String>

Gets and sets the property AllowedHeaders.

Headers that are specified in the Access-Control-Request-Headers header. These headers are allowed in a preflight OPTIONS request. In response to any preflight OPTIONS request, Amazon S3 returns any requested headers that are allowed.

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Public Property AllowedMethods System.Collections.Generic.List<System.String>

Gets and sets the property AllowedMethods.

An HTTP method that you allow the origin to execute. Valid values are GET, PUT, HEAD, POST, and DELETE.

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Public Property AllowedOrigins System.Collections.Generic.List<System.String>

Gets and sets the property AllowedOrigins.

One or more origins you want customers to be able to access the bucket from.

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Public Property ExposeHeaders System.Collections.Generic.List<System.String>

Gets and sets the property ExposeHeaders.

One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequest object).

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Public Property Id System.String

Gets and sets the property Id.

Unique identifier for the rule. The value cannot be longer than 255 characters.

Public Property MaxAgeSeconds System.Nullable<System.Int32>

Gets and sets the property MaxAgeSeconds.

The time in seconds that your browser is to cache the preflight response for the specified resource.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer