Apêndice: objeto OPTIONS
Descrição
Um navegador pode enviar essa solicitação de simulação para o Amazon S3 para determinar se ele pode enviar uma solicitação real com a origem, o método HTTP e os cabeçalhos específicos.
O Amazon S3 oferece suporte ao compartilhamento de recursos de origem cruzada (CORS), permitindo que você adicione um sub-recurso cors em um bucket. Quando um navegador envia essa solicitação de simulação, o Amazon S3 responde avaliando as regras definidas na configuração de cors.
Se cors não estiver habilitado no bucket, o Amazon S3 retornará uma resposta 403
Forbidden.
Para obter mais informações sobre o CORS, consulte Como habilitar o compartilhamento de recursos de origem cruzada no Guia do usuário do Amazon Simple Storage Service.
Solicitações
Sintaxe
OPTIONS /ObjectNameHTTP/1.1 Host:BucketName.s3.amazonaws.com Origin:OriginAccess-Control-Request-Method:HTTPMethodAccess-Control-Request-Headers:RequestHeader
Parâmetros da solicitação
Essa operação não introduz nenhum parâmetro de solicitação específico, mas pode conter parâmetros de solicitação exigidos pela solicitação real.
Cabeçalhos de solicitação
| Name (Nome) | Descrição | Obrigatório |
|---|---|---|
Origin |
Identifica a origem da solicitação de origem cruzada para o Amazon S3. Por exemplo, http://www.exemplo.com. Tipo: string Padrão: nenhum |
Sim |
Access-Control-Request-Method |
Identifica qual método HTTP será usado na solicitação real. Tipo: string Padrão: nenhum |
Sim |
Access-Control-Request-Headers |
Uma lista delimitada por vírgulas de cabeçalhos HTTP que serão enviados na solicitação real. Por exemplo, para colocar um objeto com criptografia do lado do servidor, essa solicitação de simulação determinará se é possível incluir o cabeçalho Tipo: string Padrão: nenhum |
Não |
Elementos da solicitação
Essa implementação da operação não usa elementos de solicitação.
Respostas
Cabeçalhos de resposta
| Cabeçalho | Descrição |
|---|---|
Access-Control-Allow-Origin |
A origem que você enviou em sua solicitação. Se a origem na solicitação não for permitida, o Amazon S3 não incluirá esse cabeçalho na resposta. Tipo: string |
Access-Control-Max-Age |
Por quanto tempo, em segundos, os resultados da solicitação de simulação podem ser armazenados em cache. Tipo: string |
Access-Control-Allow-Methods |
O método HTTP que foi enviado na solicitação original. Se o método na solicitação não for permitido, o Amazon S3 não incluirá esse cabeçalho na resposta. Tipo: string |
Access-Control-Allow-Headers |
Uma lista delimitada por vírgulas de cabeçalhos HTTP que o navegador pode enviar na solicitação real. Se algum dos cabeçalhos solicitados não for permitido, o Amazon S3 não incluirá esse cabeçalho na resposta e a resposta não conterá nenhum dos cabeçalhos com o prefixo Tipo: string |
Access-Control-Expose-Headers |
Uma lista delimitada por vírgulas de cabeçalhos HTTP. Esse cabeçalho fornece ao cliente JavaScript acesso a esses cabeçalhos na resposta à solicitação real. Tipo: string |
Elementos de resposta
Essa implementação da operação não retorna elementos de resposta.
Exemplos
Exemplo: enviar uma solicitação de simulação OPTIONS para um bucket habilitado para cors
Um navegador pode enviar essa solicitação de simulação para o Amazon S3 para determinar se ele pode enviar a solicitação PUT real da origem http://www.exemplo.com para o bucket do Amazon S3 chamado examplebucket.
Exemplo de solicitação
OPTIONS /exampleobject HTTP/1.1 Host: examplebucket.s3.amazonaws.com Origin: http://www.example.com Access-Control-Request-Method: PUT
Resposta da amostra
HTTP/1.1 200 OK x-amz-id-2: 6SvaESv3VULYPLik5LLl7lSPPtSnBvDdGmnklX1HfUl7uS2m1DF6td6KWKNjYMXZ x-amz-request-id: BDC4B83DF5096BBE Date: Wed, 21 Aug 2012 23:09:55 GMT Etag: "1f1a1af1f1111111111111c11aed1da1" Access-Control-Allow-Origin: http://www.example.com Access-Control-Allow-Methods: PUT Access-Control-Expose-Headers: x-amz-request-id Content-Length: 0 Server: AmazonS3
Recursos relacionados
