Pour répertorier la configuration CORS d'un bucket, envoyez une requête GET limitée à un bucket et utilisez le paramètre de chaîne de requête cors
.
La configuration CORS est renvoyée dans un document XML dans le corps de la réponse.
Pour plus d'informations sur la configuration CORS, consultez la page Configurer le partage des ressources entre origines multiples (CORS).
Paramètres de la chaîne de requête
Paramètre | Description | Requis |
---|---|---|
cors |
Il permet d'afficher la configuration CORS d'un bucket existant. | Non |
Pour en savoir plus sur les paramètres à inclure lors de la création et de l'utilisation d'URL signées, consultez la section Paramètres des chaînes de requête d'URL signée.
En-têtes de requête
Voir les en-têtes de requêtes courants.
Éléments du corps de la requête
Cette requête n'inclut pas de document XML dans le corps de la requête.
Syntaxe des requêtes
La syntaxe suivante s'applique aux requêtes de bucket GET utilisant le paramètre de chaîne de requête cors
.
GET /?cors HTTP/1.1 Host: BUCKET_NAME.storage.googleapis.com Date: DATE Content-Length: 0 Authorization: AUTHENTICATION_STRING
En-têtes de réponse
La requête peut renvoyer divers en-têtes de réponse en fonction des en-têtes de requête que vous utilisez.
Éléments du corps de la réponse
Les éléments de corps de réponse suivants ne s'appliquent que si vous utilisez le paramètre de chaîne de requête cors
pour obtenir la configuration CORS du bucket.
Élément | Description |
---|---|
CorsConfig |
Conteneur pour un ou plusieurs conteneurs de configuration Cors. Si vous spécifiez plusieurs configurations "Cors", sachez que les configurations Cors seront évaluées dans l'ordre indiqué dans le conteneur CorsConfig, la première configuration Cors correspondant à l'origine et la méthode de la requête utilisée pour déterminer les en-têtes de réponse CORS à ajouter à la réponse. s'affiche en haut de l'écran. |
Cors |
Conteneur pour une configuration CORS à appliquer au bucket. Vous pouvez spécifier plusieurs origines et plusieurs méthodes dans chaque conteneur Cors. Il existe une correspondance si l'origine de la requête correspond à l'un des origines du conteneur Cors et que la méthode de requête correspond à l'une des méthodes du conteneur Cors. |
Origins |
Conteneur des origines autorisées pour le partage des ressources entre origines multiples avec Cloud Storage. |
Origin |
Origine autorisée pour le partage des ressources entre origines multiples avec ce bucket Cloud Storage. Par exemple, https://origin1.example.com . |
Methods |
Conteneur pour un ou plusieurs éléments de méthode HTTP, en spécifiant les méthodes compatibles avec cette configuration CORS. |
Method |
Méthode HTTP utilisée dans cette configuration. Les valeurs valides sont DELETE , GET , HEAD , POST et PUT .
OPTIONS est interprété comme une requête préliminaire, vous n'avez donc pas besoin de spécifier cette méthode dans votre configuration CORS. |
ResponseHeaders |
Conteneur facultatif pour un ou plusieurs éléments ResponseHeader. |
ResponseHeader |
Spécifie un en-tête de réponse que le user-agent est autorisé à partager entre les origines. |
MaxAgeSec |
Valeur indiquant le nombre de secondes pendant lesquelles le user-agent est autorisé à mettre en cache la réponse. Cet élément est facultatif. Si cette valeur est omise, le service utilise une valeur par défaut. S'il est spécifié plusieurs fois, le dernier élément est accepté sans notification. La valeur est renvoyée dans l'en-tête Access-Control-Max-Age dans les réponses aux requêtes préliminaires. |