CreateLocationAzureBlob - AWS DataSync
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CreateLocationAzureBlob

Membuat lokasi transfer untuk wadah Microsoft Azure Blob Storage. AWS DataSync dapat menggunakan lokasi ini sebagai sumber transfer atau tujuan. Anda dapat melakukan transfer dengan atau tanpa DataSync agen yang terhubung ke wadah Anda.

Sebelum memulai, pastikan Anda tahu cara DataSync mengakses Azure Blob Storage dan bekerja dengan tingkatan akses dan jenis gumpalan.

Sintaksis Permintaan

{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "ContainerUrl": "string",
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SasConfiguration": { 
      "Token": "string"
   },
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam format JSON.

AccessTier

Menentukan tingkat akses yang Anda inginkan objek atau file Anda ditransfer ke. Ini hanya berlaku ketika menggunakan lokasi sebagai tujuan transfer. Untuk informasi selengkapnya, lihat Tingkat akses.

Tipe: String

Nilai yang Valid: HOT | COOL | ARCHIVE

Wajib: Tidak

AgentArns

(Opsional) Menentukan Nama Sumber Daya Amazon (ARN) agen yang dapat terhubung dengan wadah Penyimpanan Azure Blob Anda. DataSync Jika Anda menyiapkan transfer lintas cloud tanpa agen, Anda tidak perlu menentukan nilai untuk parameter ini.

Anda dapat menentukan lebih dari satu agen. Untuk informasi selengkapnya, lihat Menggunakan beberapa agen untuk transfer Anda.

catatan

Pastikan Anda mengonfigurasi parameter ini dengan benar saat pertama kali membuat lokasi penyimpanan. Anda tidak dapat menambah atau menghapus agen dari lokasi penyimpanan setelah Anda membuatnya.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 4 item.

Batasan Panjang: Panjang maksimum 128.

Pola: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$

Wajib: Tidak

AuthenticationType

Menentukan metode otentikasi yang DataSync digunakan untuk mengakses Penyimpanan Azure Blob Anda. DataSync dapat mengakses penyimpanan gumpalan menggunakan tanda tangan akses bersama (SAS).

Tipe: String

Nilai yang Valid: SAS | NONE

Wajib: Ya

BlobType

Menentukan jenis gumpalan yang Anda inginkan objek atau file Anda saat mentransfernya ke Azure Blob Storage. Saat ini, DataSync hanya mendukung pemindahan data ke Azure Blob Storage sebagai blob blok. Untuk informasi selengkapnya tentang jenis gumpalan, lihat dokumentasi Azure Blob Storage.

Tipe: String

Nilai yang Valid: BLOCK

Wajib: Tidak

CmkSecretConfig

Menentukan informasi konfigurasi untuk rahasia DataSync -managed, yang mencakup token otentikasi yang DataSync digunakan untuk mengakses lokasi AzureBlob penyimpanan tertentu, dengan yang dikelola pelanggan. AWS KMS key

Ketika Anda menyertakan paramater ini sebagai bagian dari CreateLocationAzureBlob permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan token otentikasi yang Anda tentukan SasConfiguration untuk membuat rahasia yang DataSync dikelola untuk menyimpan kredensil akses lokasi.

Pastikan DataSync memiliki izin untuk mengakses kunci KMS yang Anda tentukan.

catatan

Anda dapat menggunakan CmkSecretConfig (withSasConfiguration) atau CustomSecretConfig (withoutSasConfiguration) untuk memberikan kredensi untuk permintaan. CreateLocationAzureBlob Jangan berikan kedua parameter untuk permintaan yang sama.

Tipe: Objek CmkSecretConfig

Wajib: Tidak

ContainerUrl

Menentukan URL wadah Penyimpanan Azure Blob yang terlibat dalam transfer Anda.

Tipe: String

Kendala Panjang: Panjang maksimum 325.

Pola: ^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$

Wajib: Ya

CustomSecretConfig

Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana token otentikasi untuk lokasi AzureBlob penyimpanan disimpan dalam teks biasa. Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia.

catatan

Anda dapat menggunakan CmkSecretConfig (withSasConfiguration) atau CustomSecretConfig (withoutSasConfiguration) untuk memberikan kredensi untuk permintaan. CreateLocationAzureBlob Jangan berikan kedua parameter untuk permintaan yang sama.

Tipe: Objek CustomSecretConfig

Wajib: Tidak

SasConfiguration

Menentukan konfigurasi SAS yang memungkinkan DataSync untuk mengakses Penyimpanan Azure Blob Anda.

catatan

Jika Anda memberikan token otentikasi menggunakanSasConfiguration, tetapi tidak memberikan detail konfigurasi rahasia menggunakan CmkSecretConfig atauCustomSecretConfig, kemudian DataSync menyimpan token menggunakan rahasia manajer rahasia AWS akun Anda.

Tipe: Objek AzureBlobSasConfiguration

Wajib: Tidak

Subdirectory

Menentukan segmen jalur jika Anda ingin membatasi transfer Anda ke direktori virtual dalam wadah Anda (misalnya,/my/images).

Tipe: String

Batasan Panjang: Panjang maksimum 1024.

Pola: ^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$

Wajib: Tidak

Tags

Menentukan label yang membantu Anda mengkategorikan, memfilter, dan mencari sumber daya Anda. AWS Sebaiknya buat setidaknya tag nama untuk lokasi transfer Anda.

Tipe: Array objek TagListEntry

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.

Diperlukan: Tidak

Sintaksis Respons

{
   "LocationArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

LocationArn

ARN dari lokasi transfer Penyimpanan Azure Blob yang Anda buat.

Tipe: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InternalException

Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .

Kode Status HTTP: 500

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: