get_cors_policy
(**kwargs)¶Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.
To use this operation, you must have permission to perform the MediaStore:GetCorsPolicy
action. By default, the container owner has this permission and can grant it to others.
See also: AWS API Documentation
Request Syntax
response = client.get_cors_policy(
ContainerName='string'
)
[REQUIRED]
The name of the container that the policy is assigned to.
{
'CorsPolicy': [
{
'AllowedOrigins': [
'string',
],
'AllowedMethods': [
'PUT'|'GET'|'DELETE'|'HEAD',
],
'AllowedHeaders': [
'string',
],
'MaxAgeSeconds': 123,
'ExposeHeaders': [
'string',
]
},
]
}
Response Structure
The CORS policy assigned to the container.
A rule for a CORS policy. You can add up to 100 rules to a CORS policy. If more than one rule applies, the service uses the first applicable rule listed.
One or more response headers that you want users to be able to access from their applications (for example, from a JavaScript XMLHttpRequest
object).
Each CORS rule must have at least one AllowedOrigins
element. The string value can include only one wildcard character (*), for example, http://*.example.com. Additionally, you can specify only one wildcard character to allow cross-origin access for all origins.
Identifies an HTTP method that the origin that is specified in the rule is allowed to execute.
Each CORS rule must contain at least one AllowedMethods
and one AllowedOrigins
element.
Specifies which headers are allowed in a preflight OPTIONS
request through the Access-Control-Request-Headers
header. Each header name that is specified in Access-Control-Request-Headers
must have a corresponding entry in the rule. Only the headers that were requested are sent back.
This element can contain only one wildcard character (*).
The time in seconds that your browser caches the preflight response for the specified resource.
A CORS rule can have only one MaxAgeSeconds
element.
One or more headers in the response that you want users to be able to access from their applications (for example, from a JavaScript XMLHttpRequest
object).
This element is optional for each rule.
Exceptions
MediaStore.Client.exceptions.ContainerInUseException
MediaStore.Client.exceptions.ContainerNotFoundException
MediaStore.Client.exceptions.CorsPolicyNotFoundException
MediaStore.Client.exceptions.InternalServerError