CORS kurallarını yapılandırma

Başka origin’lerden gelen web sayfalarındaki betiklerin bir kovaya istek gönderebilmesi için kovaya CORS kuralları ekleyin. Kuralları REST API üzerinden ekler ve kaldırırsınız; konsol, kovanın kurallarını ve bunların yürürlükte olup olmadığını gösterir.

Başlamadan önceBağlantıyı kopyalayın

• Abonelikte veya projede Sahip veya Katkıda bulunan rolüne ya da Block & Object Storage için Yönet erişimi olan özel bir role sahip olmanız gerekir.
• PC_TOKEN ortam değişkeninde storage:write kapsamına sahip bir API belirtecine ihtiyacınız vardır. Bkz. Servis hesapları ve API belirteçleri ve API belirteçleriyle kimlik doğrulama.
• Kovanın ID’sine ihtiyacınız vardır: kovanın Genel bakış sekmesinde Kova kimliği değerini kopyalayın.
• Projenizin ID’sine ihtiyacınız vardır. Bkz. Projenin ID’sini bulma.

CORS kuralları nasıl uygulanırBağlantıyı kopyalayın

Nesne deposu her kova için tek bir CORS politikası tutar; bu nedenle platform, kovanın tüm kurallarını bu politikada birleştirir:

• İzin verilen origin’ler, tüm kuralların origin’lerinin birleşimidir.
• Açılan başlıklar, yani tarayıcı betiklerinin okuyabildiği yanıt başlıkları, tüm kuralların başlıklarının birleşimidir.
• Max age, yani bir tarayıcının ön kontrol (preflight) yanıtını ne kadar süre önbelleğe alabileceği, tüm kuralların en uzun değeridir.

CORS kuralı olmayan bir kovanın kendine ait bir CORS politikası yoktur.

Kural alanlarıBağlantıyı kopyalayın

Bir kovanın en fazla 100 CORS kuralı olabilir. Birleştirilmiş origin listesi ve birleştirilmiş açılan başlıklar listesi, her biri nesne deposunun tek bir meta veri değeri için belirlediği limite sığmalıdır; bu limiti aşacak bir kural reddedilir ve hata, limiti bayt cinsinden belirtir.

CORS kuralı eklemeBağlantıyı kopyalayın

curl -X POST "https://<api-host>/api/v1/scopes/<project-id>/storage/buckets/<bucket-id>/configuration-rules" \
  -H "Authorization: Bearer $PC_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"type":"cors","cors":{"origins":["https://app.example"],"methods":["GET","PUT"],"headers":["ETag"],"maxAgeSeconds":3600}}'

{"id":"<rule-id>","bucketId":"<bucket-id>","type":"cors","cors":{"id":"<rule-id>","origins":["https://app.example"],"methods":["GET","PUT"],"headers":["ETag"],"maxAgeSeconds":3600},"lifecycle":null,"replication":null}

Örnekteki gibi her kural için yeni bir değerle Idempotency-Key başlığı gönderin. Bir isteği aynı anahtar ve gövdeyle tekrarlarsanız API, ikinci bir kural eklemek yerine ilk isteğin oluşturduğu kuralı döndürür. Başlık olmadan tekrarlanan bir istek ikinci bir kural ekler. İstek biçimi için bkz. POST/scopes/{scopeId}/storage/buckets/{bucketId}/configuration-rules.

Kural hemen kaydedilir ve arka planda nesne deposuna uygulanır. Kuralın ne zaman yürürlüğe girdiğini görmek için kovanın CORS sekmesini kontrol edin.

Kuralların yürürlükte olup olmadığını kontrol etmeBağlantıyı kopyalayın

Sekme her kuralın İzin verilen origin'ler, Açılan başlıklar ve Max age değerlerini listeler. Listenin üstündeki bir satır, en son değişikliğin durumunu gösterir:

API üzerinden GET/scopes/{scopeId}/storage/buckets/{bucketId} kuralları corsRules içinde, durumu corsApply.status içinde döndürür: pending, applied veya failed. Kovanın kuralları hiç değişmediyse corsApply değeri null olur.

CORS kuralını kaldırmaBağlantıyı kopyalayın

curl "https://<api-host>/api/v1/scopes/<project-id>/storage/buckets/<bucket-id>" \
  -H "Authorization: Bearer $PC_TOKEN"

curl -X DELETE "https://<api-host>/api/v1/scopes/<project-id>/storage/buckets/<bucket-id>/configuration-rules/<rule-id>" \
  -H "Authorization: Bearer $PC_TOKEN"

Başarılı bir istek 204 No Content döndürür ve platform kalan kuralları nesne deposuna uygular. Son kuralı kaldırdığınızda kovanın CORS politikası kaldırılır. Bkz. DELETE/scopes/{scopeId}/storage/buckets/{bucketId}/configuration-rules/{configurationRuleId}.

Bir kuralı değiştirmek için kuralı kaldırın ve yeni bir kural ekleyin. Kurallar düzenlenemez.

SonuçBağlantıyı kopyalayın

İzin verilen origin’lerden gelen tarayıcı istekleri, kovanın birleştirilmiş politikasının belirlediği CORS başlıklarını alır.

Sorun gidermeBağlantıyı kopyalayın

İlgili içerikBağlantıyı kopyalayın

• Kova görünürlüğü ve erişim
• Nesne yükleme, indirme ve silme
• Idempotent istekler
• Hatalar